MegTrustDevelopers

List workspace wallets

Balances are decimal strings and identify the network. Unreadable balances return an error instead of zero. Without limit and cursor, every wallet is returned in one response (unchanged). With limit (or cursor), one page is returned, ordered by wallet id: follow meta.next_cursor until it is null. A page reads balances only for its own wallets, so page a large workspace.

GET/api/v1/wallets

Balances are decimal strings and identify the network. Unreadable balances return an error instead of zero. Without limit and cursor, every wallet is returned in one response (unchanged). With limit (or cursor), one page is returned, ordered by wallet id: follow meta.next_cursor until it is null. A page reads balances only for its own wallets, so page a large workspace.

Authorization

KeyId Timestamp Signature
x-api-key-id<token>

Key ID registered by your organisation administrator.

In: header

x-api-timestamp<token>

Unix seconds within ±300 seconds of the server clock.

In: header

x-api-signature<token>

Padded base64 Ed25519 signature over timestamp, METHOD, exact path+query, lowercase SHA256(raw body), Idempotency-Key or empty string, joined with LF. Legacy HMAC uses lowercase hex HMAC-SHA256. Signing is required; entering a static value is insufficient.

In: header

Query Parameters

limit?integer

Page size. Omit both limit and cursor to receive every wallet in one response. Defaults to 25 when only cursor is sent.

Range1 <= value <= 100
cursor?string

meta.next_cursor from the previous page (the last wallet id on it).

Formatuuid
_request_id?string

Fresh random UUID per attempt, included in the signed path. Avoids duplicate signatures for identical requests in the same second.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/wallets"
{  "data": [    {      "id": "string",      "name": "string",      "status": "active",      "address": "string",      "deposit_addresses": [        {          "network": "string",          "network_name": "string",          "address": "string"        }      ],      "networks": [        {          "id": "string",          "name": "string"        }      ],      "balances": [        {          "asset": "string",          "network": "string",          "amount": "string",          "available": "string",          "usd_value": 0        }      ],      "total_usd": 0    }  ],  "meta": {    "count": 0,    "limit": 0,    "next_cursor": "string",    "offset": 0,    "next_offset": 0,    "idempotent_replay": true,    "already_exists": true,    "stale": true  }}