CounterpartiesСписок контрагентов

Список контрагентов

Контрагенты Vault'а (по createdAt desc, keyset-пагинация) со счётчиками адресов и операций. По умолчанию — только активные.

curl -X GET "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/counterparties?search=example_string&kind=exchange&address=123%20Main%20St&groupId=example_string&archived=true&limit=42&cursor=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "items": [
    {
      "id": "cmr3f41z20001psp7phmyapw3",
      "vaultId": "example_string",
      "name": "Binance",
      "description": "example_string",
      "kind": "exchange",
      "tagsJson": [
        "example_string"
      ],
      "avatarUri": "example_string",
      "color": "#000",
      "emoji": "🏦",
      "archivedAt": "2026-07-02T11:25:15.134Z",
      "createdById": "example_string",
      "createdAt": "2026-07-02T11:25:15.134Z",
      "updatedAt": "2026-07-02T11:25:15.134Z",
      "addresses": [
        {
          "id": "example_string",
          "network": "tron",
          "address": "TExternalBinanceHot1",
          "label": "hot wallet"
        }
      ],
      "_count": {
        "addresses": 42,
        "transactions": 42,
        "incomingTransactions": 42
      }
    }
  ],
  "nextCursor": "example_string"
}
GET
/api/v1/vaults/{code}/counterparties
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
addressstring

Точный on-chain адрес — найти контрагента-владельца (reverse lookup для UI отправки)

query
groupIdstring

Только участники группы контрагентов («папки» в UI)

query
archivedstring

true — только архивные (default: только активные)

Options: true, false
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

kindstring
Example:
exchange
addressstring

Точный on-chain адрес — найти контрагента-владельца (reverse lookup для UI отправки)

groupIdstring

Только участники группы контрагентов («папки» в UI)

archivedstring

true — только архивные (default: только активные)

Allowed values:truefalse

Responses

itemsarray
Required
nextCursorstring
Required