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

SET API (Platforms) · Wallets

Open a custodial wallet

POST/v1/wallets

Key scope: write · Success: 201

A USDC wallet held by Bridge for a verified customer, one per customer and chain (a repeat returns it; a wallet Bridge already holds for the customer on that chain is reused). Useful as a merchant's own return address or a holding balance.

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
A verified customer.
chain "base" | "ethereum" | "solana"required
The wallet's network.

Notes

  • Bridge holds the keys; neither SET nor the customer does. Not available for customers registered in New York or Texas (409 location_not_supported).

Errors

  • 400 chain_invalid
  • 404 customer_unknown
  • 409 location_not_supported
  • 409 verification_incomplete
  • 503 bridge_wallets_disabled
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.