Get (or allocate) a deposit address for the authenticated account.

GET 
/v1/deposits/addresses

Returns the on-chain deposit address for the (asset, chain) pair, allocating one from the hot-wallet pool if no address has been issued yet. The same address is returned on subsequent calls — it's a stable per-(account, asset, chain) identifier.

V0 supports asset=1 (USDC) and chain=99 (mock chain). V1+ adds chain=101 (Solana mainnet).

Request

Responses

200

Deposit address.

400

Request was malformed or failed validation. The error.code field carries the machine-readable reason; common values include invalid_request, invalid_json, invalid_order_id, invalid_instrument_id, invalid_credential_id, invalid_resolution, and operation-specific codes documented per endpoint.

401

Missing or invalid Authorization header.

404

The named resource does not exist (or belongs to another account).

503

A required downstream (matching engine, ClickHouse, custody, instrument service) is unreachable. The request was not processed; retry with backoff.