Skip to main content
POST
Transfer Stablecoin
This endpoint enables instant stablecoin transfers between addresses on the StateSet network. Supports both single and batch transfers with atomic execution.

Authentication

This endpoint requires a valid API key with stablecoin:transfer permissions.

Request Body

Single Transfer

string
required
The sender’s blockchain addressExample: stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu
string
required
The recipient’s blockchain address
object
required
The transfer amount

Batch Transfer

string
required
The sender’s blockchain address for all transfers
array
required
Array of transfer objects

Common Fields

string
Optional memo for the transaction
string
Transaction priority: “low”, “medium”, “high” (affects gas price)Default: “medium”
string
Unique key to prevent duplicate transfers
object
Additional metadata for the transfer
string
ISO 8601 timestamp for scheduled transfers (future feature)

Response

string
Unique transfer identifier
string
Object type: “transfer” or “batch_transfer”
string
Blockchain transaction hash
string
Transfer status: “pending”, “confirmed”, “failed”
array
Array of individual transfers (for batch transfers)
object
Total amount transferred (for batch)
object
Fee breakdown
integer
Block height of confirmation
string
ISO 8601 timestamp
string
ISO 8601 timestamp of confirmation

Error Codes

Transfer Limits

Best Practices

  1. Use idempotency keys to prevent duplicate transfers
  2. Batch transfers when sending to multiple recipients to save on fees
  3. Set appropriate priority based on urgency
  4. Include memos for better transaction tracking
  5. Validate addresses before initiating transfers

Code Examples