Balance transfers

Move available stablecoin balance between wallets you own or send it to another StarSwap account by email. The ledger applies each debit and credit atomically.

Amount format

amountMicros uses six-decimal stablecoin units. For example, 25000000 represents 25.000000.

curl https://starswap.cc/api/v1/wallet-transfers \
  -X POST \
  -H "Authorization: Bearer $STARSWAP_API_KEY" \
  -H "Idempotency-Key: transfer-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "fromWalletId":"wlt_source",
    "toWalletId":"wlt_target",
    "amountMicros":"25000000"
  }'

Transfer rules

Both wallets must belong to the authenticated account and be active. The source wallet needs enough available balance. Reserved order funds cannot be transferred.

Send to another account

The recipient email must already belong to a StarSwap account. The transfer credits that account's main wallet immediately and does not use an onchain network.

curl https://starswap.cc/api/v1/account-transfers \
  -X POST \
  -H "Authorization: Bearer $STARSWAP_API_KEY" \
  -H "Idempotency-Key: account-transfer-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "fromWalletId":"wlt_source",
    "recipientEmail":"recipient@example.com",
    "amountMicros":"25000000"
  }'

Account transfers cannot be recalled. A sender cannot transfer to the email on the same account.