Токены и сети

Официальные страницы: Supported Chains и Supported Assets

Откуда берётся список токенов#

Единственный актуальный источник — сам API: GET /v0/tokens. Список большой и меняется со временем, поэтому в документации он не фиксируется. Посмотреть его можно прямо в песочнице (шаблон «01 — список токенов») или на странице «Котировка», где токены подгружаются автоматически.

Как читать запись токена#

{
  "assetId": "nep141:wrap.near",
  "decimals": 24,
  "blockchain": "near",
  "symbol": "wNEAR",
  "price": 3.15,
  "priceUpdatedAt": "2026-01-01T00:00:00.000Z",
  "contractAddress": "wrap.near"
}

• assetId — главный идентификатор. Именно его подставляют в originAsset / destinationAsset котировки. Один и тот же тикер (например, USDC) существует в разных сетях с разными assetId — не перепутайте сеть!
• decimals — суммы в API передаются в наименьших единицах. Формула: сумма_в_API = человеческая_сумма × 10^decimals. Например, 2.5 USDC при decimals: 6 → 2500000.
• blockchain — сеть токена. Среди поддерживаемых: near, eth, base, arb, btc, sol, ton, doge, xrp, bsc, pol, tron, sui, op, avax, stellar, aptos, cardano и другие (полный список — в ответе /v0/tokens).

Частые ошибки#

• Неправильные decimals — сумма получается в миллионы раз больше или меньше задуманной. Страница «Котировка» в портале конвертирует сумму автоматически.
• Тикер тот, сеть не та — пользователь ждёт USDC в Base, а котировка сделана на USDC в Ethereum. Всегда сверяйте поле blockchain.
• Адрес получателя не из той сети — recipient должен быть валидным адресом сети токена назначения, refundTo — сети токена источника.