Deposit addresses
Base path: /v1/deposit-addresses. Requires authentication.
| Method | Path | Description |
|---|---|---|
POST | /v1/deposit-addresses | Create or fetch a deposit address for a customer. |
GET | /v1/deposit-addresses | List your deposit addresses (paginated). |
GET | /v1/deposit-addresses/:id | Get one deposit address. |
Create or fetch
POST body accepts:
| Field | Required | Description |
|---|---|---|
chainId | yes | Chain from Chains. |
remoteCustomerId | no | Your customer identifier. |
metadata | no | Opaque JSON attached to the address. |
When remoteCustomerId is supplied, the call is idempotent: the same customer and chain always resolve to the same address.
Give the returned address to your customer. Incoming transfers are detected automatically — see Deposits.