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

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

Batch Transfer

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

Common Fields

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

Response

id
string
Unique transfer identifier
object
string
Object type: “transfer” or “batch_transfer”
transaction_hash
string
Blockchain transaction hash
status
string
Transfer status: “pending”, “confirmed”, “failed”
transfers
array
Array of individual transfers (for batch transfers)
total_amount
object
Total amount transferred (for batch)
fees
object
Fee breakdown
block_height
integer
Block height of confirmation
created_at
string
ISO 8601 timestamp
confirmed_at
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