Skip to main content
POST
Redeem Stablecoin
This endpoint allows verified users to redeem their stablecoins for fiat currency. Redemptions are subject to KYC/AML verification and minimum/maximum limits.

Authentication

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

Request Body

sender
string
required
The blockchain address holding the stablecoins to redeemExample: stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu
amount
object
required
The amount and denomination of stablecoins to redeem
destination
object
required
Destination for the fiat funds
reference_id
string
required
Unique reference ID for this redemption transaction
compliance
object
Compliance information
metadata
object
Additional metadata for the redemption

Response

id
string
Unique identifier for the redemption transaction
object
string
Object type, always “stablecoin_redemption”
sender
string
The sender address
amount
object
The redeemed amount
transaction_hash
string
Blockchain transaction hash for the burn
status
string
Status: “pending”, “processing”, “completed”, “failed”, “cancelled”
estimated_arrival
string
Estimated arrival date for fiat funds
fees
object
Fee breakdown
created_at
string
ISO 8601 timestamp of creation
completed_at
string
ISO 8601 timestamp of completion

Error Codes

Redemption Limits

  • Minimum: $100 USD equivalent
  • Maximum: $1,000,000 USD per transaction
  • Daily Limit: $5,000,000 USD per account
  • Monthly Limit: Based on account tier

Processing Times

Webhooks

Configure webhooks to receive real-time updates:

Code Examples