Wallets API

API endpoints

Wallets API

Wallet endpoints створюють і повертають blockchain addresses у межах організації. Гаманець належить одному рахунку операційного журналу та одній мережі.

Операції

MethodPathScopeОпис
POST/api/v1/walletswallets:createСтворення адреси гаманця
GET/api/v1/walletswallets:readСписок гаманців організації
GET/api/v1/wallets/{walletId}wallets:readЧитання одного гаманця

Створення гаманця

POST /api/v1/wallets

Серед обов’язкових headers: X-Idempotency-Key і X-Api-Body-Hash.

json
{
  "chain": "tron:nile",
  "accountId": "ledger-account-id"
}

Поточна schema дозволяє значення tron:mainnet і tron:nile для chain. Перевіряйте фактичну доступність через GET /api/v1/assets, а не припускайте, що кожне значення enum увімкнено для вашої організації.

Response 201 містить:

  • id;
  • chain;
  • accountId та accountName;
  • address;
  • status: ACTIVE, DISABLED або ARCHIVED;
  • createdAt та updatedAt.

Список гаманців

GET /api/v1/wallets підтримує:

  • cursor pagination: cursor, limit;
  • фільтри статусу й мережі: status, chain;
  • пошук адреси: addressContains;
  • фільтри часу: createdFrom, createdTo;
  • фільтр рахунку: accountId;
  • сортування: sortBy, sortOrder.

Безпечні повтори

Повторюйте ту саму логічну операцію створення з тим самим X-Idempotency-Key та ідентичним body. Повторне використання ключа з іншим request призводить до idempotency conflict.

Помилки

Створення гаманця може повернути IDEMPOTENCY_KEY_REQUIRED, IDEMPOTENCY_KEY_INVALID, IDEMPOTENCY_CONFLICT, RESOURCE_NOT_FOUND, UNSUPPORTED_CHAIN, PLAN_LIMIT_REACHED або UPSTREAM_UNAVAILABLE.