Skip to main content
POST
Create deposit addresses
Send chainIds as an array after checking availability with List deposit networks. Addresses are created, or reused, for each requested chain, and the response lists the supported assets for each address. If any requested chain is paused, the whole batch fails before any address is provisioned. Idempotency-Key is optional; reusing a key with different input returns a conflict. See Depositing funds.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Idempotency-Key
string

Optional retry key for create/generate calls. Reusing the same key with different input returns a conflict.

Required string length: 1 - 128
Example:

"deposit-address-user-123"

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Body

application/json
chainIds
enum<integer>[]
required

One or more chain IDs. Supported deposit chain IDs: Arbitrum=42161, Ethereum=1, Base=8453, Polygon=137, BNB Smart Chain=56, Avalanche=43114, Robinhood Chain=4663, Tempo=4217, Solana=10103, Movement=10002, Tron=728126428, Bitcoin=10001.

Required array length: 1 - 12 elements
Available options:
42161,
1,
8453,
137,
56,
43114,
4663,
4217,
10103,
10002,
728126428,
10001
Example:

Response

Deposit addresses

accountId
string
required
Example:

"acct_123"

depositAddresses
object[]
required
nextCursor
string

Pass this value as cursor to fetch the next page.