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

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

Response

string
Unique identifier for the redemption transaction
string
Object type, always “stablecoin_redemption”
string
The sender address
object
The redeemed amount
string
Blockchain transaction hash for the burn
string
Status: “pending”, “processing”, “completed”, “failed”, “cancelled”
string
Estimated arrival date for fiat funds
object
Fee breakdown
string
ISO 8601 timestamp of creation
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