SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-08
Browse: SET API (Platforms)

SET API (Platforms) · Conversion

Open a Conversion Address

POST/v1/conversion_addresses

Key scope: write · Success: 201

Crypto to crypto: stablecoin sent to the address is converted or moved across chains and delivered to the wallet named (for example USDC on Base to USDC on Solana, or USDC to EURC).

Platform key beneficiary: {"type": "platform"} (the platform's own wallet) is refused with 403 platform_funds_not_allowed unless SET has allowed platform funds for that platform. Use the merchant's own wallet, {"type": "customer", …}. Without platform funds allowed, returnAddress is required and must be an address the merchant controls (400 return_address_required); the platform's own registered address is refused.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

customer stringrequired
An approved customer.
chain stringrequired
The chain payers send on.
currency "usdc" | "usdt" | "pyusd" | "eurc"required
The stablecoin it accepts.
destination { asset, address, beneficiary }required
Where it is delivered and whose wallet that is.
returnAddress string
Where a payment that cannot be delivered returns.

Errors

  • 400 currency_invalid
  • 400 asset_invalid
  • 400 route_not_supported
  • 400 beneficiary_invalid
  • 403 platform_funds_not_allowed
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.