Depa LogoDocsv1
API Reference

Blockchain Wallets

Blockchain wallets hold or receive stablecoins and crypto for an account, on POLYGON, ETHEREUM, SOLANA, TRON or BITCOIN.

  • Deposit wallets (kind: deposits) are addresses Depa generates for the account. Funds sent to them are credited to the account's ledger. Don't send an address.
  • Source wallets (kind: source) are external addresses you whitelist as payout destinations. address is required.

Some networks need a memo or tag on transfers; it's returned in memo when it applies.

List blockchain wallets

GET/accounts/{account_id}/blockchain_wallets

Returns the blockchain wallets of an account. Filter with filter[kind]=deposits or filter[kind]=source.

Authorization

BearerAuth
AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

Query Parameters

filter[kind]?string

Return only deposits or source wallets.

Value in

  • "deposits"
  • "source"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/blockchain_wallets?filter%5Bkind%5D=deposits"
{  "data": [    {      "id": "9a7b3c2d-1e4f-4a6b-8c9d-0e1f2a3b4c5d",      "name": "USDC on Polygon",      "memo": null,      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",      "network": "POLYGON",      "kind": "deposits",      "balance": [        [          "USDC",          "3000.0"        ]      ],      "created_at": 1772813114    }  ]}
POST/accounts/{account_id}/blockchain_wallets

Adds a wallet to the account:

  • kind: deposits generates a deposit address for the account. Leave address out.
  • kind: source whitelists an external address you'll send payouts to. address is required.

Authorization

BearerAuth
AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

address is required for source wallets and must be left out for deposits wallets.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/blockchain_wallets" \  -H "Content-Type: application/json" \  -d '{    "name": "USDC on Polygon",    "currency": "USDC",    "network": "POLYGON",    "kind": "deposits"  }'
{  "data": {    "id": "9a7b3c2d-1e4f-4a6b-8c9d-0e1f2a3b4c5d",    "name": "USDC on Polygon",    "memo": null,    "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",    "network": "POLYGON",    "kind": "deposits",    "balance": [      [        "USDC",        "3000.0"      ]    ],    "created_at": 1772813114  }}
GET/accounts/{account_id}/blockchain_wallets/{id}

Returns a wallet with its address, network and balance.

Authorization

BearerAuth
AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid
id*string

ID of the wallet.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/blockchain_wallets/9a7b3c2d-1e4f-4a6b-8c9d-0e1f2a3b4c5d"
{  "data": {    "id": "9a7b3c2d-1e4f-4a6b-8c9d-0e1f2a3b4c5d",    "name": "USDC on Polygon",    "memo": null,    "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",    "network": "POLYGON",    "kind": "deposits",    "balance": [      [        "USDC",        "3000.0"      ]    ],    "created_at": 1772813114  }}
🍪 We do not track your behaviour or use any cookie on this site.