AddressesАдреса Vault'а

Адреса Vault'а

Адреса Vault'а (по createdAt desc, keyset-пагинация), обогащённые asset-информацией и decimal-балансом. Для участника — СВОИ (createdById из сессии) + опционально расшаренные (?access); для admin — ВЕСЬ Vault (?userId= сузить до владельца).

Сценарии:

  • все мои usdt-адреса — ?token=usdt
  • поиск моего адреса — ?search=TQ5k (подстрока в on-chain адресе или label)
curl -X GET "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses?token=usdt&search=example_string&folderId=example_string&access=own&userId=example_string&limit=42&cursor=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "items": [
    {
      "id": "cmr3f41z20001psp7phmyapw3",
      "address": "TQ5kohbBSdorGoDBmCGUmDL7RUvNr75mBC",
      "derivationPath": "m/44/195/0/0/1/1/0",
      "network": "tron",
      "pathIndex": 42,
      "segmentsJson": {
        "app_id": 0,
        "purpose": 1,
        "asset": 1,
        "stage": 0
      },
      "label": "example_string",
      "description": "example_string",
      "tagsJson": [
        "example_string"
      ],
      "logoUri": "example_string",
      "color": "#000",
      "emoji": "💳",
      "balance": "1500000",
      "balances": [
        {
          "tokenId": "example_string",
          "asset": "usdt",
          "symbol": "USDT",
          "decimals": 42,
          "available": "example_string",
          "availableDecimal": "1.951234",
          "reserved": "example_string",
          "reservedDecimal": "example_string"
        }
      ],
      "tokenId": "example_string",
      "createdAt": "2026-07-02T11:25:15.134Z",
      "asset": "usdt",
      "assetName": "John Doe",
      "assetSymbol": "USDT",
      "balanceDecimal": "1.5",
      "owner": {
        "id": "example_string",
        "name": "John Doe",
        "username": "John Doe",
        "image": "example_string",
        "color": "example_string",
        "emoji": "example_string"
      },
      "access": {
        "isOwner": true,
        "isAdmin": true,
        "canView": true,
        "canTransfer": true
      }
    }
  ],
  "nextCursor": "example_string"
}
GET
/api/v1/vaults/{code}/addresses
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

better-auth session token. Мобилка/сервисы. Веб использует cookie.

better-auth session token. Мобилка/сервисы. Веб использует cookie.
API Key (cookie: better-auth.session_token)
path
codestring
Required

Уникальный код Vault'а (slug)

query
tokenstring

Код основного токена адреса

query
folderIdstring

Только адреса из моей папки (address-folders)

query
accessstring

own — только мои (дефолт); shared — расшаренные мне (view); all — оба. Для admin не применяется: он видит весь Vault (см. userId)

Options: own, shared, all
query
userIdstring

Только для admin: адреса конкретного владельца. Без параметра админ видит ВЕСЬ Vault (своих адресов у него нет — это надзорная роль). Не-админ может указать только себя, иначе 403

query
limitinteger
Min: 1 • Max: 100
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. better-auth session token. Мобилка/сервисы. Веб использует cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

codestring
Required

Уникальный код Vault'а (slug)

Example:
demo_vault

Query Parameters

tokenstring

Код основного токена адреса

Example:
usdt
folderIdstring

Только адреса из моей папки (address-folders)

accessstring

own — только мои (дефолт); shared — расшаренные мне (view); all — оба. Для admin не применяется: он видит весь Vault (см. userId)

Allowed values:ownsharedall
userIdstring

Только для admin: адреса конкретного владельца. Без параметра админ видит ВЕСЬ Vault (своих адресов у него нет — это надзорная роль). Не-админ может указать только себя, иначе 403

Responses

itemsarray
Required
nextCursorstring
Required