Введение

Документация описывает работу с TokenSpot REST API. Методы и структуры данных наследуются от стандартного REST API компании Tokentech https://exchange-api.tokens.team/.

Используйте этот API для интеграции TokenSpot с вашими приложениями.

Авторизация

#!/bin/bash

API_KEY=key
API_SECRET=secret
RECV_WINDOW=50000
TIMESTAMP=$(date +%s%N)
METHOD="GET"
BASE_URL="https://api.tokenspot.com"
ENDPOINT="/api/v1/spot/my_trades"
QUERY="symbol=usdtrub"

# Только для POST
BODY=""

# Собираем payload
if [ "$METHOD" == "GET" ]; then
  PAYLOAD="$QUERY"
elif [ "$METHOD" == "POST" ]; then
  PAYLOAD="${BODY}${QUERY}"
else
  echo "Unsupported method"
  exit 1
fi

# Строка для подписи
STRING_TO_SIGN="${TIMESTAMP}${API_KEY}${RECV_WINDOW}${PAYLOAD}"
SIGNATURE=$(echo -n "$STRING_TO_SIGN" | openssl dgst -sha256 -hmac "$API_SECRET" | sed 's/^.* //')

echo "${BASE_URL}${ENDPOINT}?${QUERY}"
echo "TS-API-API-KEY: ${API_KEY}"
echo "TS-API-TIMESTAMP: ${TIMESTAMP}"
echo "TS-API-RECV-WINDOW: ${RECV_WINDOW}"
echo "TS-API-SIGN: ${SIGNATURE}"

# Выполняем запрос
curl -X $METHOD "${BASE_URL}${ENDPOINT}?${QUERY}" </span>
  -H "TS-API-API-KEY: ${API_KEY}" </span>
  -H "TS-API-TIMESTAMP: ${TIMESTAMP}" </span>
  -H "TS-API-RECV-WINDOW: ${RECV_WINDOW}" </span>
  -H "TS-API-SIGN: ${SIGNATURE}"

echo

Часть эндпоинтов API публичные, они не требуют авторизации пользователя. Для авторизации в приватных эндпоинтах необходимо создать API-ключ в интерфейсе биржи. Ключ используется для генерации подписи к каждому запросу:

DATA = TIMESTAMP + KEY_UID + RECV_WINDOW + PAYLOAD

SIGN = HMAC-SHA256(DATA, API_KEY_SECRET)

Aлгоритм HMAC

Где:

TIMESTAMP - текущее время в ms
KEY_UID - идентификатор API-ключа
RECV_WINDOW - время жизни запроса в ms
PAYLOAD - query params для GET и body для POST запроса
API_KEY_SECRET - секретная часть API-ключа, этим ключом происходит шифрование

Итоговое значение записывается в заголовок запроса TS-API-SIGN.

TIMESTAMP записывается в заголовок запроса TS-API-TIMESTAMP.

RECV_WINDOW записывается в заголовок запроса TS-API-RECV-WINDOW.

KEY_UID записывается в заголовок запроса TS-API-API-KEY.

Скачать форму генерации подписи

# Для Bash используйте curl с заголовками:
API_SECRET=secret
RECV_WINDOW=50000
TIMESTAMP=$(date +%s%N)
METHOD="GET"
BASE_URL="https://api.tokenspot.com"
ENDPOINT="/api/v1/spot/my_trades"
QUERY="symbol=usdtrub"

# Только для POST
BODY=""

# Собираем payload
if [ "$METHOD" == "GET" ]; then
  PAYLOAD="$QUERY"
elif [ "$METHOD" == "POST" ]; then
  PAYLOAD="${BODY}${QUERY}"
else
  echo "Unsupported method"
  exit 1
fi

# Строка для подписи
STRING_TO_SIGN="${TIMESTAMP}${API_KEY}${RECV_WINDOW}${PAYLOAD}"
SIGNATURE=$(echo -n "$STRING_TO_SIGN" | openssl dgst -sha256 -hmac "$API_SECRET" | sed 's/^.* //')

echo "${BASE_URL}${ENDPOINT}?${QUERY}"
echo "TS-API-API-KEY: ${API_KEY}"
echo "TS-API-TIMESTAMP: ${TIMESTAMP}"
echo "TS-API-RECV-WINDOW: ${RECV_WINDOW}"
echo "TS-API-SIGN: ${SIGNATURE}"

# Выполняем запрос
curl -X $METHOD "${BASE_URL}${ENDPOINT}?${QUERY}" \
  -H "TS-API-API-KEY: ${API_KEY}" \
  -H "TS-API-TIMESTAMP: ${TIMESTAMP}" \
  -H "TS-API-RECV-WINDOW: ${RECV_WINDOW}" \
  -H "TS-API-SIGN: ${SIGNATURE}"

Аккаунт

Данные API-ключа

Получить свойства вашего API-ключа

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/account/api_key?uid=<KEY_UID>'

{
  "uid": "ea76a0-625567-8e1e2c-095186-25d794",
  "name": "Latlux-Regrant-3627",
  "network_mask": "177.134.101.169/10,47ac:2a32:9844:46f3:29fc:a07c:5e96:8389/88",
  "trading_permitted": true,
  "withdrawals_permitted": false,
  "p2p_permitted": false
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/account/api_key

Query Параметры

Параметр	Описание	Обязательный
uid	Идентификатор API-ключа	Да

Структура Ответа

Параметр	Описание
uid	Идентификатор API-ключа
name	Название
network_mask	Доступные IP-адреса клиента
trading_permitted	Разрешение на торги
withdrawals_permitted	Разрешение на вывод средств
p2p_permitted	Разрешение на P2P

Информация об аккаунте

Получить информацию о вашем аккаунте

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/account/info'

{
  "uid": "IDB125E1104870BD",
  "email": "[email protected]",
  "nickname": "Eli",
  "balances": [
    {
      "currency": "uni",
      "balance": 78117.1378,
      "locked": 18317.9048,
      "order_locked": 80388.3688,
      "withdraw_locked": 35523.4774,
      "p2p_locked": 20568.3897,
      "credit_limit": 28334.3285,
      "available_to_withdraw": 74817.2686,
      "credit_usage_fee": 43376.4969,
      "credit_overdue_fee": 26051.6899
    },
    {
      "currency": "ron",
      "balance": 17200.2909,
      "locked": 18329.0022,
      "order_locked": 33506.8273,
      "withdraw_locked": 49781.0224,
      "p2p_locked": 34346.6512,
      "credit_limit": 80428.7848,
      "available_to_withdraw": 96707.4754,
      "credit_usage_fee": 34137.5793,
      "credit_overdue_fee": 37548.4508
    },
    {
      "currency": "dash",
      "balance": 16836.1861,
      "locked": 82704.5325,
      "order_locked": 88573.5079,
      "withdraw_locked": 39156.8262,
      "p2p_locked": 26516.2794,
      "credit_limit": 24725.6324,
      "available_to_withdraw": 80015.8622,
      "credit_usage_fee": 77331.0349,
      "credit_overdue_fee": 23152.5369
    }
  ],
  "trading_permitted": true,
  "withdrawals_permitted": false,
  "p2p_permitted": true
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/account/info

Структура Ответа

Параметр	Описание
uid	Идентификатор аккаунта
email	Email аккаунта
nickname	Никнейм
balances	Балансы аккаунта
trading_permitted	Разрешение на торги
withdrawals_permitted	Разрешение на вывод средств
p2p_permitted	Разрешение на P2P

Структура Баланса

Параметр	Описание
currency	Валюта
balance	Баланс
locked	Средств зарезервировано суммарно
order_locked	Средств зарезервировано на заявках
withdraw_locked	Средств зарезервировано на выводах
p2p_locked	Средств зарезервировано на P2P
available_to_withdraw	Доступно для вывода
credit_limit	Лимит кредитных средств
credit_usage_fee	Плата за пользование кредитом
credit_overdue_fee	Плата за просроченный кредит

Средства

Список методов работы с фиатом

Получить список методов пополнения счета и вывода средств в фиате

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/asset/methods_fiat?currency=djf&direction=deposit'

[
  {
    "id": 9511,
    "direction": "deposit",
    "currency": "djf",
    "title": "Банковский перевод (Ак Барс Банк)",
    "description": "...",
    "instructions": "...",
    "min_amount": 52412.1446,
    "max_amount": 52198.3672,
    "rounding": "0.0001",
    "fee": 40895.6893,
    "fee_fixed": 56814.0954,
    "fee_limit": 88439.6922
  },
  {
    "id": 9026,
    "direction": "deposit",
    "currency": "djf",
    "title": "Банковский перевод (Новикомбанк)",
    "description": "...",
    "instructions": "...",
    "min_amount": 25671.2974,
    "max_amount": 64675.1907,
    "rounding": "0.0001",
    "fee": 45297.8297,
    "fee_fixed": 99136.3783,
    "fee_limit": 55188.4474
  },
  {
    "id": 6016,
    "direction": "deposit",
    "currency": "djf",
    "title": "Банковский перевод (Райффайзенбанк)",
    "description": "...",
    "instructions": "...",
    "min_amount": 52653.1267,
    "max_amount": 59764.6297,
    "rounding": "0.0001",
    "fee": 38005.9971,
    "fee_fixed": 34311.6033,
    "fee_limit": 94503.8454
  },
  {
    "id": 3856,
    "direction": "deposit",
    "currency": "djf",
    "title": "Торговый терминал (Иркутск)",
    "description": "...",
    "instructions": "...",
    "min_amount": 81567.3838,
    "max_amount": 47005.8174,
    "rounding": "0.0001",
    "fee": 35932.4026,
    "fee_fixed": 26579.4388,
    "fee_limit": 47988.3442
  },
  {
    "id": 3744,
    "direction": "deposit",
    "currency": "djf",
    "title": "Наличные (Екатеринбург)",
    "description": "...",
    "instructions": "...",
    "min_amount": 31125.8869,
    "max_amount": 76695.6826,
    "rounding": "0.0001",
    "fee": 85532.6439,
    "fee_fixed": 29121.4523,
    "fee_limit": 80783.2555
  },
  {
    "id": 2903,
    "direction": "deposit",
    "currency": "djf",
    "title": "Наличные (Ижевск)",
    "description": "...",
    "instructions": "...",
    "min_amount": 72967.3869,
    "max_amount": 87634.7128,
    "rounding": "0.0001",
    "fee": 30228.4195,
    "fee_fixed": 15007.7131,
    "fee_limit": 77845.4267
  },
  {
    "id": 1448,
    "direction": "deposit",
    "currency": "djf",
    "title": "Наличные (Белгород)",
    "description": "...",
    "instructions": "...",
    "min_amount": 23692.5435,
    "max_amount": 82232.2669,
    "rounding": "0.0001",
    "fee": 48544.4946,
    "fee_fixed": 37610.7437,
    "fee_limit": 98758.8266
  },
  {
    "id": 1330,
    "direction": "deposit",
    "currency": "djf",
    "title": "Наличные (Уфа)",
    "description": "...",
    "instructions": "...",
    "min_amount": 29729.0269,
    "max_amount": 22070.3666,
    "rounding": "0.0001",
    "fee": 70968.7143,
    "fee_fixed": 75554.3822,
    "fee_limit": 15596.5237
  },
  {
    "id": 1098,
    "direction": "deposit",
    "currency": "djf",
    "title": "Банковский перевод (ЮниКредит Банк)",
    "description": "...",
    "instructions": "...",
    "min_amount": 65303.9133,
    "max_amount": 95816.8635,
    "rounding": "0.0001",
    "fee": 12969.2357,
    "fee_fixed": 89072.2674,
    "fee_limit": 13118.2258
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/asset/methods_fiat

Query Параметры

Параметр	Описание	Обязательный	Значения
currency	Валюта	Да	usr / rub / eur...
direction	Направление (вывод или пополнение)	Нет	withdraw / deposit

Структура Объекта

Параметр	Описание
id	Идентификатор
direction	Направление (вывод или пополнение)
currency	Валюта
title	Название
description	Описание
instructions	Инструкции
min_amount	Минимальная сумма
max_amount	Максимальная сумма
rounding	Правило округления сумм
fee	Комиссия
fee_fixed	Фиксированная комиссия
fee_limit	Лимитированная комиссия

Список валют

Получить список поддерживаемых активов (валют)

curl -X GET 'https://api.tokenspot.com/api/v1/asset/list?type=coin'

[
  {
    "id": "doge",
    "symbol": "Ð",
    "chains": [
      {
        "withdraw_fee": 0.4031,
        "title": "doge",
        "deposit_status": "allowed",
        "deposit_status_description": "",
        "withdraw_status": "allowed",
        "withdraw_status_description": "",
        "blockchain": "doge",
        "min_deposit_amount": 0.1804,
        "min_withdraw_amount": 0.3562
      }
    ],
    "type": "coin",
    "precision": 4
  },
  {
    "id": "eth",
    "symbol": "Ξ",
    "chains": [
      {
        "withdraw_fee": 0.0991,
        "title": "eth",
        "deposit_status": "allowed",
        "deposit_status_description": "",
        "withdraw_status": "allowed",
        "withdraw_status_description": "",
        "blockchain": "eth",
        "min_deposit_amount": 0.1807,
        "min_withdraw_amount": 0.7458
      }
    ],
    "type": "coin",
    "precision": 4
  },
  {
    "id": "sol",
    "symbol": "◎",
    "chains": [
      {
        "withdraw_fee": 0.6935,
        "title": "sol",
        "deposit_status": "allowed",
        "deposit_status_description": "",
        "withdraw_status": "allowed",
        "withdraw_status_description": "",
        "blockchain": "sol",
        "min_deposit_amount": 0.1999,
        "min_withdraw_amount": 0.8908
      }
    ],
    "type": "coin",
    "precision": 4
  },
  {
    "id": "xmr",
    "symbol": "ɱ",
    "chains": [
      {
        "withdraw_fee": 0.1095,
        "title": "xmr",
        "deposit_status": "allowed",
        "deposit_status_description": "",
        "withdraw_status": "allowed",
        "withdraw_status_description": "",
        "blockchain": "xmr",
        "min_deposit_amount": 0.8177,
        "min_withdraw_amount": 0.8629
      }
    ],
    "type": "coin",
    "precision": 4
  },
  {
    "id": "atom",
    "symbol": "⚛",
    "chains": [
      {
        "withdraw_fee": 0.4127,
        "title": "atom",
        "deposit_status": "allowed",
        "deposit_status_description": "",
        "withdraw_status": "allowed",
        "withdraw_status_description": "",
        "blockchain": "atom",
        "min_deposit_amount": 0.2166,
        "min_withdraw_amount": 0.5551
      }
    ],
    "type": "coin",
    "precision": 4
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/asset/list

Query Параметры

Параметр	Описание	Обязательный	Значения
type	Вид активов (фиат или крипта)	Нет	fiat / coin

Структура Объекта

Параметр	Описание
id	Валюта
symbol	Символ валюты
chains	Список сетей (только для коинов)
type	Вид актива (фиат или крипта)
precision	Точность при расчете

Структура Объекта Chain

Параметр	Описание
withdraw_fee	Комиссия на вывод
title	Название
deposit_status	Статус работы пополнения
deposit_status_description	Описание статуса пополнения
withdraw_status	Статус работы вывода средств
withdraw_status_description	Описание статуса вывода средств
blockchain	Название блокчейн-сети
min_deposit_amount	Минимальная сумма пополнения
min_withdraw_amount	Минимальная сумма вывода

Список блокчейнов

Получить список поддерживаемых блокчейн-сетей

curl -X GET 'https://api.tokenspot.com/api/v1/asset/blockchains'

[
  {
    "key": "ethereum",
    "explorer_transaction": "https://etherscan.io/tx/b1d62a45880da44c2ee203f0fba6a0b7679c82605049203643f1a348bdd22e9d",
    "explorer_address": "https://etherscan.io/address/0x28e7b5d4b9253fa2df96a15c0de3c46e3d5de156",
    "min_confirmations": 1,
    "hold_timeout_minutes": 31
  },
  {
    "key": "ada",
    "explorer_transaction": "https://cardanoscan.io/transaction/fea9cfa0ace32726d8ad742909c00938c5c30b963270cbf019a4e9a8fef74bb8",
    "explorer_address": "https://cardanoscan.io/address/19jzNPBRzDhFy8S1Avyz3ocJ9JeQhvHmnP",
    "min_confirmations": 9,
    "hold_timeout_minutes": 65
  },
  {
    "key": "trx",
    "explorer_transaction": "https://tronscan.org/#/transaction/f7c68b5419ad87baab2713b150751f0d0cd0972ce017b9c3e1b390db84179132",
    "explorer_address": "https://tronscan.org/#/address/15woMDdPhvHcETJcSVN9czZpVgcnDwvLjF",
    "min_confirmations": 8,
    "hold_timeout_minutes": 38
  },
  {
    "key": "xrp",
    "explorer_transaction": "https://xrpscan.com/tx/7e308e82e3b5ea0230702de5ee2ad54795b505cbbb140a527e96e47dec7360ab",
    "explorer_address": "https://xrpscan.com/account/14E5DBsHkpaEGmxECwtHLjRiipEcxPGneG",
    "min_confirmations": 1,
    "hold_timeout_minutes": 90
  },
  {
    "key": "bch",
    "explorer_transaction": "https://blockchair.com/bitcoin-cash/transaction/ded037b4b20857415ae3418a262ef46036390af046c38bbc3a33e372ab465e58",
    "explorer_address": "https://blockchair.com/bitcoin-cash/address/1D5qZn5TqVRHvox35XQAz9YL2quzHoKQyL",
    "min_confirmations": 8,
    "hold_timeout_minutes": 93
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/asset/blockchains

Структура Объекта Blockchain

Параметр	Описание
key	Имя сети
explorer_transaction	Формат транзакции проводника
explorer_address	Формат адреса
min_confirmations	Минимальное количество подтверждений в сети
hold_timeout_minutes	Время блокировки

Информация о валюте

Получить свойства актива (валюты)

curl -X GET 'https://api.tokenspot.com/api/v1/asset/info?id=doge'

{
  "id": "doge",
  "symbol": "Ð",
  "chains": [
    {
      "withdraw_fee": "0.2112",
      "title": "doge",
      "deposit_status": "allowed",
      "deposit_status_description": "",
      "withdraw_status": "allowed",
      "withdraw_status_description": "",
      "blockchain": "doge",
      "min_deposit_amount": "0.0921",
      "min_withdraw_amount": "0.4514"
    }
  ],
  "type": "coin",
  "precision": 4
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/asset/info

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор валюты	Да

Структура Ответа

Параметр	Описание
id	Валюта
symbol	Символ валюты
chains	Список сетей (только для коинов)
type	Вид актива (фиат или крипта)
precision	Точность при расчете

Структура Объекта Chain

Параметр	Описание
withdraw_fee	Комиссия на вывод
title	Название
deposit_status	Статус работы пополнения
deposit_status_description	Описание статуса пополнения
withdraw_status	Статус работы вывода средств
withdraw_status_description	Описание статуса вывода средств
blockchain	Название блокчейн-сети
min_deposit_amount	Минимальная сумма пополнения
min_withdraw_amount	Минимальная сумма вывода

Балансы кошельков

Получить список балансов клиента

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/asset/balance_list'

[
  {
    "currency": "mop",
    "balance": "4585.8335",
    "locked": "0.2003",
    "order_locked": "0.8435",
    "withdraw_locked": "0.5263",
    "p2p_locked": "0.3899",
    "credit_limit": "44820.6",
    "available_to_withdraw": "76085.2361",
    "credit_usage_fee": "0.8547",
    "credit_overdue_fee": "0.7078"
  },
  {
    "currency": "gnf",
    "balance": "1418.6028",
    "locked": "0.4502",
    "order_locked": "0.3148",
    "withdraw_locked": "0.1537",
    "p2p_locked": "0.7586",
    "credit_limit": "12738.7",
    "available_to_withdraw": "76009.9925",
    "credit_usage_fee": "0.1379",
    "credit_overdue_fee": "0.6799"
  },
  {
    "currency": "ton",
    "balance": "2383.6536",
    "locked": "8.4187",
    "order_locked": "0.5189",
    "withdraw_locked": "8.8996",
    "p2p_locked": "0.3672",
    "credit_limit": "97127.4",
    "available_to_withdraw": "18395.9236",
    "credit_usage_fee": "0.4596",
    "credit_overdue_fee": "0.9783"
  },
  {
    "currency": "xrp",
    "balance": "3937.4469",
    "locked": "6.9627",
    "order_locked": "0.5063",
    "withdraw_locked": "7.5551",
    "p2p_locked": "0.6685",
    "credit_limit": "57061.8",
    "available_to_withdraw": "42954.0371",
    "credit_usage_fee": "0.5897",
    "credit_overdue_fee": "0.4828"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/asset/balance_list

Структура Объекта

Параметр	Описание
currency	Валюта
balance	Баланс
locked	Средств зарезервировано суммарно
order_locked	Средств зарезервировано на заявках
withdraw_locked	Средств зарезервировано на выводах
p2p_locked	Средств зарезервировано на P2P
available_to_withdraw	Доступно для вывода
credit_limit	Лимит кредитных средств
credit_usage_fee	Плата за пользование кредитом
credit_overdue_fee	Плата за просроченный кредит

Информация о балансе

Получить баланс в активе (валюте)

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/asset/balance?currency=usdt'

{
  "currency": "usdt",
  "balance": "5491.4439",
  "locked": "9.3068",
  "order_locked": "0.1351",
  "withdraw_locked": "0.9637",
  "p2p_locked": "0.9968",
  "credit_limit": "59172.5",
  "available_to_withdraw": "68072.8573",
  "credit_usage_fee": "0.5568",
  "credit_overdue_fee": "0.1992"
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/asset/balance

Query Параметры

Параметр	Описание	Обязательный	Значения
currency	Валюта кошелька	Да	eur/ usd / usdt / btc ...

Структура Объекта

Параметр	Описание
currency	Валюта
balance	Баланс
locked	Средств зарезервировано суммарно
order_locked	Средств зарезервировано на заявках
withdraw_locked	Средств зарезервировано на выводах
p2p_locked	Средств зарезервировано на P2P
available_to_withdraw	Доступно для вывода
credit_limit	Лимит кредитных средств
credit_usage_fee	Плата за пользование кредитом
credit_overdue_fee	Плата за просроченный кредит

Торговля

Общая информация о торговле

Статусы торговой заявки

Название	Описание
new	Новая заявка
canceled	Отменена
filled	Выполнена полностью
partially filled	Выполнена частично

Рыночные сделки (Deprecated)

Получить последние сделки на рынке. Запрос устарел, используйте запрос "/spot/all_market_trades"

curl -X GET 'https://api.tokenspot.com/api/v1/spot/market_trades?order_by=DESC&symbol=avaxghs'

[
  {
    "id": 10,
    "price": "523.1",
    "amount": "611.88",
    "total": "632.5",
    "symbol": "dotqar",
    "created_at": "2026-01-07T04:36:02Z"
  },
  {
    "id": 9,
    "price": "258.2",
    "amount": "459.19",
    "total": "270.5",
    "symbol": "dashnok",
    "created_at": "2025-11-16T13:42:33Z"
  },
  {
    "id": 7,
    "price": "144.9",
    "amount": "188.62",
    "total": "329.1",
    "symbol": "xmruah",
    "created_at": "2025-10-02T14:55:07Z"
  },
  {
    "id": 6,
    "price": "640.1",
    "amount": "118.29",
    "total": "693.3",
    "symbol": "xrpxpd",
    "created_at": "2025-06-29T12:25:04Z"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/market_trades

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	null	Валютная пара	Да
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет

Структура Объекта Сделки

Параметр	Описание
id	Идентификатор
price	Цена покупки
amount	Объем
total	Стоимость покупки
symbol	Валютная пара
created_at	Время создания

Рыночные сделки

Получить последние сделки на рынке

curl -X GET 'https://api.tokenspot.com/api/v1/spot/all_market_trades?order_by=DESC&symbol=dogegbp'

[
  {
    "id": "6",
    "price": "815.7",
    "amount": "581.85",
    "total": "648.5",
    "symbol": "dogegbp",
    "created_at": "2025-02-09T05:42:19Z",
    "hid": "575594",
    "side": "buy"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/all_market_trades

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	null	Валютная пара	Да
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет

Структура Объекта Сделки

Параметр	Описание
id	Идентификатор
hid	Идентификатор
price	Цена покупки
amount	Объем
total	Стоимость покупки
symbol	Валютная пара
created_at	Время создания
side	Направление заявки, buy или sell

Глубина стакана

Получить глубину биржевого "стакана" для торговой пары (по убыванию цены)

{:symbol=>"xmrkyd"}

curl -X GET 'https://api.tokenspot.com/api/v1/spot/depth?symbol=xmrkyd'

{
  "timestamp": 1769518579,
  "asks": [
    {
      "price": "871764.38",
      "volume": "0.779018",
      "amount": "6807221.94"
    },
    {
      "price": "932066.29",
      "volume": "0.479833",
      "amount": "1690293.88"
    },
    {
      "price": "930756.11",
      "volume": "0.845884",
      "amount": "9629260.49"
    },
    {
      "price": "182339.99",
      "volume": "0.983346",
      "amount": "3411784.83"
    },
    {
      "price": "710479.39",
      "volume": "0.369997",
      "amount": "5524526.58"
    },
    {
      "price": "729829.01",
      "volume": "0.550105",
      "amount": "2664263.47"
    },
    {
      "price": "484663.03",
      "volume": "0.787304",
      "amount": "3261694.84"
    },
    {
      "price": "131539.86",
      "volume": "0.845627",
      "amount": "4013567.53"
    }
  ],
  "bids": [
    {
      "price": "947160.65",
      "volume": "0.512839",
      "amount": "2721409.84"
    },
    {
      "price": "252095.14",
      "volume": "0.353593",
      "amount": "6985369.19"
    },
    {
      "price": "789179.87",
      "volume": "0.573178",
      "amount": "6644929.02"
    }
  ]
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/depth

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	all	Валютная пара	Да

Структура Ответа

Параметр	Описание
timestamp	Время
asks	Данные по продаже
bids	Данные по покупке

Структура Объекта ask / bid

Параметр	Описание
price	Цена покупки
volume	Стоимость покупки
amount	Объем

Японские свечи по торговым парам в ожидании

Получить историю цен ("японские свечи") с учётом сделок, которые ещё не попали на график

curl -X GET 'https://api.tokenspot.com/api/v1/spot/kline_pending?limit=85&period=240&symbol=ltcbif'

{
  "k": {
    "close": 243700.38,
    "high": 869192.65,
    "low": 572402.99,
    "open": 349723.95,
    "time": 1769487902,
    "volume": 5
  },
  "trades": [
    {
      "tid": 8,
      "market": "ltcbif",
      "type": "buy",
      "date": 1769518526,
      "amount": "14.48",
      "price": "85938.27",
      "volume": "0.712834",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 7,
      "market": "ltcbif",
      "type": "sell",
      "date": 1769518525,
      "amount": "49.16",
      "price": "65281.18",
      "volume": "0.856661",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 6,
      "market": "ltcbif",
      "type": "buy",
      "date": 1769518524,
      "amount": "35.98",
      "price": "26632.07",
      "volume": "0.392043",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 5,
      "market": "ltcbif",
      "type": "sell",
      "date": 1769518523,
      "amount": "64.43",
      "price": "65279.87",
      "volume": "0.965606",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 4,
      "market": "ltcbif",
      "type": "buy",
      "date": 1769518522,
      "amount": "73.99",
      "price": "73431.61",
      "volume": "0.499486",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 3,
      "market": "ltcbif",
      "type": "buy",
      "date": 1769518521,
      "amount": "59.05",
      "price": "77767.89",
      "volume": "0.716408",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 2,
      "market": "ltcbif",
      "type": "sell",
      "date": 1769518520,
      "amount": "10.31",
      "price": "68507.97",
      "volume": "0.286352",
      "ask": "ltc",
      "bid": "bif"
    },
    {
      "tid": 1,
      "market": "ltcbif",
      "type": "buy",
      "date": 1769518519,
      "amount": "93.21",
      "price": "32233.34",
      "volume": "0.309959",
      "ask": "ltc",
      "bid": "bif"
    }
  ]
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/kline_pending

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	null	Валютная пара	Да
trade_id	null	Идентификатор первой сделки	Да
period	1	Временной период, по которому строятся "свечи". Варианты значений: 1, 5, 15, 30, 60, 120, 240, 360, 720, 1440, 4320, 10080	Нет
time_from	null	Начальное UNIX-время в секундах	Нет
time_to	null	Конечное UNIX-время в секундах	Нет
limit	null	Число точек	Нет

Структура Ответа

Параметр	Описание
k	Время
trades	Данные по продаже

Структура Объекта "k"

Параметр	Описание
close	Цена закрытия
high	Максимальная цена
low	Минимальная цена
open	Цена открытия
time	Время
volume	Объем торгов

Японские свечи

Получить историю цен ("японские свечи") для торговой пары

curl -X GET 'https://api.tokenspot.com/api/v1/spot/kline?limit=6&period=30&symbol=tonttd'

[
  {
    "close": 273575.55,
    "high": 324079.68,
    "low": 843323.09,
    "open": 717534.94,
    "time": 1769518562,
    "volume": 3
  },
  {
    "close": 934282.96,
    "high": 448059.05,
    "low": 573461.17,
    "open": 381309.58,
    "time": 1769518504,
    "volume": 2
  },
  {
    "close": 837080.27,
    "high": 478014.51,
    "low": 820663.31,
    "open": 361088.38,
    "time": 1769518502,
    "volume": 8
  },
  {
    "close": 145456.46,
    "high": 788771.06,
    "low": 929224.23,
    "open": 206922.98,
    "time": 1769518208,
    "volume": 8
  },
  {
    "close": 108066.43,
    "high": 205502.53,
    "low": 721220.01,
    "open": 121675.74,
    "time": 1769518205,
    "volume": 9
  },
  {
    "close": 647539.48,
    "high": 224065.19,
    "low": 728576.35,
    "open": 629986.95,
    "time": 1769516892,
    "volume": 9
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/kline

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	null	Валютная пара	Да
period	1	Временной период, по которому строятся "свечи". Варианты значений: 1, 5, 15, 30, 60, 120, 240, 360, 720, 1440, 4320, 10080	Нет
time_from	null	Начальное UNIX-время в секундах	Нет
time_to	null	Конечное UNIX-время в секундах	Нет
limit	null	Число точек	Нет

Структура Объекта

Параметр	Описание
close	Цена закрытия
high	Максимальная цена
low	Минимальная цена
open	Цена открытия
time	Время
volume	Объем торгов

Мои сделки

Посмотреть свои сделки

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/spot/my_trades'

[
  {
    "id": "9",
    "order_id": 5,
    "symbol": "dogekrw",
    "is_maker": false,
    "price": "2249.1",
    "amount": "0.28",
    "total": "801.65",
    "fee": "0.744",
    "fee_size": "9.83",
    "created_at": "2025-12-20T22:29:22Z",
    "side": "buy"
  },
  {
    "id": "3",
    "order_id": 1,
    "symbol": "btcxpd",
    "is_maker": true,
    "price": "2520.6",
    "amount": "0.16",
    "total": "123.52",
    "fee": "0.911",
    "fee_size": "8.83",
    "created_at": "2025-08-04T02:55:36Z",
    "side": "buy"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/my_trades

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	all	Валютная пара	Нет
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет

Структура Объекта

Параметр	Описание
id	Идентификатор сделки
order_id	Идентификатор заказа
symbol	Валютная пара
is_maker	Продавец / Покупатель
price	Цена актива
amount	Объем
total	Итоговая стоимость
fee	Комиссия
fee_size	Объем комиссии
created_at	Время создания
side	Продажа / Покупка

Разместить заявку

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'client_order_id=2950630&price=692&side=sell&symbol=matictop&type=limit&volume=9&volume_unit=base' \
     'https://api.tokenspot.com/api/v1/spot/order'

{
  "id": "276",
  "client_order_id": "2950630",
  "symbol": "matictop",
  "remaining_volume": "1.7",
  "executed_volume": "0.4",
  "volume": 9,
  "side": "sell",
  "type": "limit",
  "status": "canceled",
  "price": 692,
  "funds_received": "0.7",
  "funds_fee": "0.7",
  "trades_count": 1,
  "avg_price": 8,
  "executed_amount": "0.9",
  "quote_amount": "0.3",
  "created_at": "2025-05-01T16:31:57Z",
  "updated_at": "2025-05-01T16:31:57Z"
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/spot/order

Query Параметры

Параметр	Описание	Обязательный
symbol	Валютная пара	Да
side	Покупка или продажа	Да
volume	Сумма	Да
type	Тип заявки 'market' или 'limit'	Да
volume_unit	В каких активах измеряется сумма (base - актив продажи, quote - актив покупки)	Да
price	Цена	Только для type 'limit'
client_order_id	Клиентский идентификатор	Нет

Структура Объекта

Параметр	Описание
id	Идентификатор заявки
client_order_id	Клиентский идентификатор
symbol	Валютная пара
remaining_volume	Оставшаяся сумма
executed_volume	Выполненная сумма
volume	Сумма
side	Покупка или продажа (sell / buy)
status	Статус (см. статусы заявок)
price	Фиксированная цена
funds_received	Средств получено
funds_fee	Комиссия
trades_count	Число переводов
avg_price	Средняя цена актива
executed_amount	Фактическая цена
quote_amount	Котировочная цена
created_at	Время создания
updated_at	Время последнего обновления

Информация о заявке

Получить свойства заявки

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/spot/order_info?id=1105'

{
  "id": "1105",
  "client_order_id": "2571",
  "symbol": "ltclak",
  "remaining_volume": "1.5",
  "executed_volume": "0.7",
  "volume": "3.2",
  "side": "ask",
  "type": "limit",
  "status": "partially_filled",
  "price": "1.6",
  "funds_received": "0.3",
  "funds_fee": "0.4",
  "trades_count": 6,
  "avg_price": 7,
  "executed_amount": "0.8",
  "quote_amount": "0.4",
  "created_at": "2025-10-10T17:32:24Z",
  "updated_at": "2025-10-10T17:32:24Z"
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/order_info

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор заявки	Нет, если указан client_order_id
client_order_id	Клиентский идентификатор	Нет, если указан id

Структура Объекта

Параметр	Описание
id	Идентификатор заявки
client_order_id	Клиентский идентификатор
symbol	Валютная пара
remaining_volume	Оставшаяся сумма
executed_volume	Выполненная сумма
volume	Сумма
side	Покупка или продажа (sell / buy)
status	Статус (см. статусы заявок)
price	Фиксированная цена
funds_received	Средств получено
funds_fee	Комиссия
trades_count	Число переводов
avg_price	Средняя цена актива
executed_amount	Фактическая цена
quote_amount	Котировочная цена
created_at	Время создания
updated_at	Время последнего обновления

Отменить заявку

Отменить одну заявку

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d '{:id=>"2299"}' \
     'https://api.tokenspot.com/api/v1/spot/cancel_order'

{
  "id": "2299",
  "client_order_id": "9593510",
  "symbol": "avaxclp",
  "remaining_volume": "5.3",
  "executed_volume": "0.9",
  "volume": "9.3",
  "side": "bid",
  "type": "limit",
  "status": "cancel",
  "price": "0.8",
  "funds_received": "0.2",
  "funds_fee": "0.9",
  "trades_count": 4,
  "avg_price": 5,
  "executed_amount": "0.3",
  "quote_amount": "0.3",
  "created_at": "2025-08-26T06:07:16Z",
  "updated_at": "2026-01-24T10:36:01Z"
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/spot/cancel_order

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор заявки	Нет, если указан client_order_id
client_order_id	Клиентский идентификатор	Нет, если указан id

Структура Объекта

Параметр	Описание
id	Идентификатор заявки
client_order_id	Клиентский идентификатор
symbol	Валютная пара
remaining_volume	Оставшаяся сумма
executed_volume	Выполненная сумма
volume	Сумма
side	Покупка или продажа (sell / buy)
status	Статус (см. статусы заявок)
price	Фиксированная цена
funds_received	Средств получено
funds_fee	Комиссия
trades_count	Число переводов
avg_price	Средняя цена актива
executed_amount	Фактическая цена
quote_amount	Котировочная цена
created_at	Время создания
updated_at	Время последнего обновления

Отменить все заявки

Отменить все ваши заявки

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/spot/cancel_all'

[
  {
    "id": "1000",
    "client_order_id": "1102765",
    "symbol": "dogehnl",
    "remaining_volume": "3.2",
    "executed_volume": "0.2",
    "volume": "4.2",
    "side": "bid",
    "type": "market",
    "status": "cancel",
    "price": "8.1",
    "funds_received": "0.9",
    "funds_fee": "0.7",
    "trades_count": 3,
    "avg_price": 9,
    "executed_amount": "0.2",
    "quote_amount": "0.1",
    "created_at": "2026-01-17T07:20:27Z",
    "updated_at": "2026-01-27T12:41:17Z"
  },
  {
    "id": "999",
    "client_order_id": "5958441",
    "symbol": "xmrirr",
    "remaining_volume": "6.5",
    "executed_volume": "0.4",
    "volume": "6.8",
    "side": "bid",
    "type": "limit",
    "status": "cancel",
    "price": "2.6",
    "funds_received": "0.7",
    "funds_fee": "0.7",
    "trades_count": 9,
    "avg_price": 4,
    "executed_amount": "0.3",
    "quote_amount": "0.5",
    "created_at": "2026-01-16T05:43:37Z",
    "updated_at": "2026-01-27T07:55:57Z"
  },
  {
    "id": "998",
    "client_order_id": "1147152",
    "symbol": "zecgip",
    "remaining_volume": "0.1",
    "executed_volume": "0.9",
    "volume": "8.5",
    "side": "bid",
    "type": "market",
    "status": "cancel",
    "price": "6.5",
    "funds_received": "0.8",
    "funds_fee": "0.1",
    "trades_count": 1,
    "avg_price": 4,
    "executed_amount": "0.8",
    "quote_amount": "0.5",
    "created_at": "2026-01-15T12:20:40Z",
    "updated_at": "2026-01-26T23:44:53Z"
  },
  {
    "id": "994",
    "client_order_id": "2334855",
    "symbol": "dogefjd",
    "remaining_volume": "6.3",
    "executed_volume": "0.2",
    "volume": "3.8",
    "side": "bid",
    "type": "market",
    "status": "cancel",
    "price": "9.8",
    "funds_received": "0.1",
    "funds_fee": "0.6",
    "trades_count": 9,
    "avg_price": 4,
    "executed_amount": "0.9",
    "quote_amount": "0.5",
    "created_at": "2026-01-09T07:52:15Z",
    "updated_at": "2026-01-26T02:09:15Z"
  },
  {
    "id": "993",
    "client_order_id": "8457926",
    "symbol": "dothuf",
    "remaining_volume": "5.1",
    "executed_volume": "0.7",
    "volume": "0.2",
    "side": "bid",
    "type": "limit",
    "status": "cancel",
    "price": "9.9",
    "funds_received": "0.4",
    "funds_fee": "0.2",
    "trades_count": 9,
    "avg_price": 1,
    "executed_amount": "0.4",
    "quote_amount": "0.7",
    "created_at": "2025-11-23T08:29:41Z",
    "updated_at": "2026-01-25T07:19:41Z"
  },
  {
    "id": "863",
    "client_order_id": "3753466",
    "symbol": "xmretb",
    "remaining_volume": "7.1",
    "executed_volume": "0.1",
    "volume": "9.5",
    "side": "bid",
    "type": "limit",
    "status": "cancel",
    "price": "8.3",
    "funds_received": "0.7",
    "funds_fee": "0.6",
    "trades_count": 3,
    "avg_price": 3,
    "executed_amount": "0.3",
    "quote_amount": "0.1",
    "created_at": "2025-07-13T00:15:14Z",
    "updated_at": "2026-01-23T06:57:55Z"
  }
]

HTTP-запрос

POST https://api.tokenspot.com/api/v1/spot/cancel_all

Query Параметры

Параметр	Описание	Обязательный
symbol	Валютная пара	Нет
currency	Валюта	Нет
side	Покупка (buy) или продажа (sell)	Нет

Структура Объекта

Параметр	Описание
id	Идентификатор заявки
client_order_id	Клиентский идентификатор
symbol	Валютная пара
remaining_volume	Оставшаяся сумма
executed_volume	Выполненная сумма
volume	Сумма
side	Покупка или продажа (sell / buy)
status	Статус (см. статусы заявок)
price	Фиксированная цена
funds_received	Средств получено
funds_fee	Комиссия
trades_count	Число переводов
avg_price	Средняя цена актива
executed_amount	Фактическая цена
quote_amount	Котировочная цена
created_at	Время создания
updated_at	Время последнего обновления

История заявок

Получить список ваших заявок (с пагинацией)

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/spot/order_history?symbol=tonkpw'

[
  {
    "id": "777",
    "client_order_id": "3365",
    "symbol": "tonkpw",
    "remaining_volume": "7.9",
    "executed_volume": "0.6",
    "volume": "7.9",
    "side": "ask",
    "type": "limit",
    "status": "filled",
    "price": "5.6",
    "funds_received": "0.5",
    "funds_fee": "0.2",
    "trades_count": 9,
    "avg_price": 3,
    "executed_amount": "0.6",
    "quote_amount": "0.7",
    "created_at": "2026-01-26T23:24:43Z",
    "updated_at": "2025-08-19T13:22:58Z"
  },
  {
    "id": "685",
    "client_order_id": "2360",
    "symbol": "tonkpw",
    "remaining_volume": "5.3",
    "executed_volume": "0.6",
    "volume": "9.2",
    "side": "bid",
    "type": "limit",
    "status": "canceled",
    "price": "2.8",
    "funds_received": "0.7",
    "funds_fee": "0.2",
    "trades_count": 4,
    "avg_price": 4,
    "executed_amount": "0.6",
    "quote_amount": "0.8",
    "created_at": "2026-01-26T23:12:22Z",
    "updated_at": "2025-06-01T08:22:24Z"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/spot/order_history

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
symbol	all	Валютная пара	Да
status	all	Статус заявки (см. статусы заявок)	Нет
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет

Структура Объекта

Параметр	Описание
id	Идентификатор заявки
client_order_id	Клиентский идентификатор
symbol	Валютная пара
remaining_volume	Оставшаяся сумма
executed_volume	Выполненная сумма
volume	Сумма
side	Покупка или продажа (sell / buy)
status	Статус (см. статусы заявок)
price	Фиксированная цена
funds_received	Средств получено
funds_fee	Комиссия
trades_count	Число переводов
avg_price	Средняя цена актива
executed_amount	Фактическая цена
quote_amount	Котировочная цена
created_at	Время создания
updated_at	Время последнего обновления

Коды TokenSpot

Комиссии

Получить данные о ваших комиссиях за создание и использование кода TokenSpot.

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/code/fees'

[
  {
    "currency": "etb",
    "withdraw_fee": "0.283",
    "deposit_fee": "0.092"
  },
  {
    "currency": "kes",
    "withdraw_fee": "0.067",
    "deposit_fee": "0.318"
  },
  {
    "currency": "wst",
    "withdraw_fee": "0.202",
    "deposit_fee": "0.055"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/code/fees

Структура Ответа

Параметр	Описание
currency	Валюта кода
deposit_fee	Комиссия на начисление кода TokenSpot
withdraw_fee	Комиссия на создание кода TokenSpot

Создание

Создать новый код TokenSpot с вашего баланса

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'amount=73.7134&client_id=30269121185&currency=kzt' \
     'https://api.tokenspot.com/api/v1/code/create'

{
  "id": "B07CCB8B1BE498704050281B8251104E2954D66055AE750B3325061C3EBD103C970CAC77BA5EDB736B31",
  "code": "HGEQOCSZDBNAPKTLJRVF",
  "client_id": "30269121185",
  "currency": "kzt",
  "amount": "73.7134",
  "used": false,
  "fee": "1.285",
  "created_at": "2025-05-24T05:09:19Z",
  "used_at": null
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/code/create

Query Параметры

Параметр	Описание	Обязательный
currency	Валюта	Да
amount	Сумма	Да
client_id	Клиентский ID кода TokenSpot	Нет

Структура Ответа

Параметр	Описание
id	Идентификатор
code	Код (отображается полностью)
client_id	Клиентский ID кода TokenSpot
currency	Валюта кода TokenSpot
amount	Сумма
used	Использован ли код
created_at	Время создания
used_at	Время использования

Зачисление

Пополнить ваш баланс кодом TokenSpot

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'code=123123123' \
     'https://api.tokenspot.com/api/v1/code/deposit'

{
  "id": "068912B774659CD08E82831C0A4E1E6D9D85E604D8A933C52779DAC092E56D95230A5D57E503C7D4ECE0",
  "code": "123123123",
  "client_id": "88668837773",
  "currency": "cve",
  "amount": "8.4",
  "used": true,
  "fee": "0.215",
  "created_at": "2025-01-29T17:20:33Z",
  "used_at": "2025-09-15T04:08:34Z"
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/code/deposit

Query Параметры

Параметр	Описание	Обязательный
code	Код	Да

Структура Ответа

Параметр	Описание
id	Идентификатор
code	Код (отображается полностью)
client_id	ID клиента
currency	Валюта кода
amount	Сумма
used	Использован ли код
created_at	Время создания
used_at	Время использования

Отмена

Вернуть код TokenSpot обратно на ваш баланс

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'id=123123123' \
     'https://api.tokenspot.com/api/v1/code/cancel'

{
  "id": "123123123",
  "code": "RJIBC***************",
  "client_id": "73151618467",
  "currency": "krw",
  "amount": "3.3",
  "used": true,
  "fee": "6.132",
  "created_at": "2025-12-03T22:41:37Z",
  "used_at": "2025-10-10T15:51:39Z"
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/code/cancel

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор кода TokenSpot	Да

Структура Ответа

Параметр	Описание
id	Идентификатор
code	Код (маскирован)
client_id	ID клиента
currency	Валюта кода
amount	Сумма
used	Использован ли код
created_at	Время создания
used_at	Время использования

Просмотр

Получить свойства кода TokenSpot

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/code/details?id=B22638111199AF'

{
  "id": "B22638111199AF",
  "code": "JWFIA***************",
  "client_id": "69667205523",
  "currency": "bsd",
  "amount": "1.7",
  "used": false,
  "fee": "0.187",
  "created_at": "2025-11-06T19:20:30Z",
  "used_at": null
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/code/details

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор кода TokenSpot	Да

Структура Ответа

Параметр	Описание
id	Идентификатор
code	Код (маскирован)
client_id	ID клиента
currency	Валюта кода
amount	Сумма
used	Использован ли код
created_at	Время создания
used_at	Время использования

История

Получить список ваших кодов TokenSpot

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/code/history?order_by=DESC'

[
  {
    "id": "2D2E4839BE992DA42A2BEE01C7CC099696908B1AE8A0C594B032B8D542637E265A89E8C32B07B8A469E5",
    "code": "SYRIH***************",
    "client_id": "56543964788",
    "currency": "top",
    "amount": "4.5",
    "used": false,
    "fee": "0.494",
    "created_at": "2026-01-26T16:23:43Z",
    "used_at": null
  },
  {
    "id": "48E8D321865C31A2BE2BD5C8A6E616A2B1A779CBB6512E3CE3C5A1BD757A3DA27DDCE3DC2680B6AA4ED0",
    "code": "XQSHZ***************",
    "client_id": "56543964788",
    "currency": "omr",
    "amount": "6.3",
    "used": false,
    "fee": "0.084",
    "created_at": "2026-01-23T03:30:03Z",
    "used_at": null
  },
  {
    "id": "61C3BD2E509641EB638CEDD2036B49DDC453CE3110A4C1C7EA1A0B0AB4CED2DEEC1069417C7DDA40EA92",
    "code": "LNHKZ***************",
    "client_id": "56543964788",
    "currency": "xdr",
    "amount": "9.6",
    "used": false,
    "fee": "0.667",
    "created_at": "2026-01-19T04:24:37Z",
    "used_at": null
  },
  {
    "id": "CC55BD216E5A17716CEDC8081552E11CB75251D97D39B327C752B27103511E0D2BD41AAB967525B8AE84",
    "code": "MRVFD***************",
    "client_id": "56543964788",
    "currency": "shp",
    "amount": "1.1",
    "used": false,
    "fee": "0.009",
    "created_at": "2026-01-06T08:05:20Z",
    "used_at": null
  },
  {
    "id": "8A5238774C6448DED03715BA232DCEB5C74AD76DE1041C6CE4D61AEC06B1B8D7A948A787E0BC26418E8C",
    "code": "GRMQC***************",
    "client_id": "56543964788",
    "currency": "dkk",
    "amount": "7.3",
    "used": true,
    "fee": "0.043",
    "created_at": "2025-12-26T11:03:50Z",
    "used_at": null
  },
  {
    "id": "C16872C9E4313756BD1E56D96BC576C35A4937BB54D3E6CC7047E07E8B70096AD37CC531E3EA87ADA3CD",
    "code": "DLPAK***************",
    "client_id": "56543964788",
    "currency": "hkd",
    "amount": "8.6",
    "used": false,
    "fee": "0.679",
    "created_at": "2025-11-04T07:11:25Z",
    "used_at": null
  },
  {
    "id": "1BDC4C40C2783A0EC82D33BD3B6C63DB8D3DAE7013B10997A8EBD85748237B626E42840D92D40A3A0461",
    "code": "VSWLN***************",
    "client_id": "56543964788",
    "currency": "sbd",
    "amount": "8.1",
    "used": false,
    "fee": "0.008",
    "created_at": "2025-03-11T02:15:06Z",
    "used_at": null
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/code/history

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
currency	all	Валюта	Нет
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет
used	all	Использован ли код	Нет

Структура Ответа

Параметр	Описание
id	Идентификатор
code	Код (маскированный)
client_id	ID клиента
currency	Валюта кода
amount	Сумма
used	Использован ли код
created_at	Время создания
used_at	Время использования

Адреса для пополнения

Создать адрес

Создать новый адрес для пополнения (если адрес не пришёл в ответе, запросите его позже по id)

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'chain=btc&currency=btc' \
     'https://api.tokenspot.com/api/v1/deposit_address/create'

{
  "id": 4597,
  "address": "https://www.blockchain.com/btc/address/1PTAkmxDzQgeRGrxJmVCGxYjdQpyeMyiZM",
  "blockchain": "btc",
  "created_at": "2025-05-27T07:54:46Z",
  "currency": "btc"
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/deposit_address/create

Query Параметры

Параметр	Описание	Обязательный
currency	Валюта	Да
chain	Блокчейн-сеть	Да

Структура Ответа

Параметр	Описание
id	Идентификатор
address	Адрес
blockchain	Блокчейн-сеть
created_at	Время создания
currency	Валюта

Данные адреса

Получить свойства адреса для пополнения (создание нового адреса занимает время, для нового адреса может понадобиться запросить свойства позже ещё раз)

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/deposit_address/info?id=1182'

{
  "id": 1182,
  "address": "https://dogechain.info/address/1RbBhcvke4zMJSvwLtM2f9eFc89x38qyG",
  "blockchain": "doge",
  "created_at": "2025-07-04T11:22:19Z",
  "currency": "doge"
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/deposit_address/info

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор адреса	Да

Структура Ответа

Параметр	Описание
id	Идентификатор
address	Адрес
blockchain	Блокчейн-сеть
created_at	Время создания

История адресов для пополнения

Получить список адресов для актива или сети

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/deposit_address/history?chain=bch&currency=bch'

[
  {
    "id": 9985,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-27T11:42:47Z",
    "currency": "bch"
  },
  {
    "id": 9971,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-27T09:06:29Z",
    "currency": "bch"
  },
  {
    "id": 9960,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-26T10:12:46Z",
    "currency": "bch"
  },
  {
    "id": 9918,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-23T03:24:00Z",
    "currency": "bch"
  },
  {
    "id": 8086,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-22T01:09:41Z",
    "currency": "bch"
  },
  {
    "id": 6964,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-21T11:47:39Z",
    "currency": "bch"
  },
  {
    "id": 5504,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2026-01-16T23:17:43Z",
    "currency": "bch"
  },
  {
    "id": 5311,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2025-12-18T04:37:21Z",
    "currency": "bch"
  },
  {
    "id": 2755,
    "address": "https://blockchair.com/bitcoin-cash/address/14xwrv3vQCXBDUugxTRGsi3key93aCczTR",
    "blockchain": "bch",
    "created_at": "2025-06-21T21:22:21Z",
    "currency": "bch"
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/deposit_address/history

Query Параметры

Параметр	Описание	Обязательный
chain	Название сети	Нет, если указан currency
currency	Валюта	Нет, если указан chain

Структура Объекта Адреса

Параметр	Описание
id	Идентификатор
address	Адрес
blockchain	Блокчейн-сеть
created_at	Время создания
currency	Валюта

Активный адрес

Получить свойства последнего адреса для пополнения (создание нового адреса занимает время, для нового адреса может понадобиться запросить свойства позже ещё раз)

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/deposit_address/last?chain=ltc&currency=ltc'

{
  "id": 6264,
  "address": "https://blockchair.com/litecoin/address/14vEvPdRDXiBas64hhEhFH63WF4kwajTC6",
  "blockchain": "ltc",
  "created_at": "2025-12-15T18:58:43Z",
  "currency": "ltc"
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/deposit_address/last

Query Параметры

Параметр	Описание	Обязательный
chain	Название сети	Да
currency	Валюта	Да

Структура Ответа

Параметр	Описание
id	Идентификатор
address	Адрес
blockchain	Блокчейн-сеть
created_at	Время создания
currency	Валюта

Депозиты

Общая информация о депозитах

Статусы депозитов

Название	Описание
submitted	Отправлен
rejected	Отклонен
accepted	Одобрен специалистом
suspected	Подозрительный депозит
fraudulent	Мошенничество
processing	В обработке
pending	В ожидании обработки
canceled	Отменен
review	На изучении

История депозитов

Получить список ваших депозитов

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/deposit/history?currency=currency=ada&status=suspected'

[
  {
    "id": "830830",
    "currency": "ada",
    "type": "coin",
    "amount": "84.36",
    "fee": "0.53",
    "txid": "834714",
    "block_number": null,
    "confirmations": null,
    "status": "suspected",
    "chain": "ada",
    "address": "https://cardanoscan.io/address/17J56Qd5myAUquNPPGmnfBKiMixffuTD2W",
    "created_at": "2025-08-14T19:41:35Z",
    "completed_at": null,
    "gateway_type": null
  },
  {
    "id": "742720",
    "currency": "ada",
    "type": "coin",
    "amount": "87.75",
    "fee": "0.84",
    "txid": "888377",
    "block_number": null,
    "confirmations": null,
    "status": "suspected",
    "chain": "ada",
    "address": "https://cardanoscan.io/address/17J56Qd5myAUquNPPGmnfBKiMixffuTD2W",
    "created_at": "2025-07-25T05:21:34Z",
    "completed_at": null,
    "gateway_type": null
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/deposit/history

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
currency	null	Валюта	Нет
chain	null	Сеть	Нет
status	null	Статус депозита (см. статусы депозитов)	Нет
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет

Структура Объекта

Параметр	Описание
id	Идентификатор депозита
currency	Валюта
type	Вид депозита (фиатная валюта / криптовалюта)
amount	Сумма
fee	Комиссия
txid	Идентификатор транзакции
block_number	Номер блока
confirmations	Подтверждения
status	Статус депозита
chain	Сеть
address	Адрес пополнения
created_at	Время создания
completed_at	Время завершения депозита
gateway_type	Вид пополнения (для фиата)

Данные депозита

Получить данные конкретного депозита

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/deposit/info?txid=604902'

{
  "id": "870628",
  "currency": "doge",
  "type": "coin",
  "amount": "71.63",
  "fee": "0.26",
  "txid": "604902",
  "block_number": null,
  "confirmations": null,
  "status": "pending",
  "chain": "doge",
  "address": "https://dogechain.info/address/1L2BPRqjSN4mNQRYF9Rt3uHDbmTZyuhwNk",
  "created_at": "2025-08-14T09:45:08Z",
  "completed_at": null,
  "gateway_type": null
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/deposit/info?id=123

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор депозита	Если нет txid
txid	Идентификатор транзакции	Если нет id

Структура Объекта

Параметр	Описание
id	Идентификатор депозита
currency	Валюта
type	Вид депозита (фиатная валюта / криптовалюта)
amount	Сумма
fee	Комиссия
txid	Идентификатор транзакции
block_number	Номер блока
confirmations	Подтверждения
status	Статус депозита
chain	Сеть
address	Адрес пополнения
created_at	Время создания
completed_at	Время завершения депозита
gateway_type	Вид пополнения (для фиата)

Выводы

Общая информация о выводах

Статусы выводов

Название	Описание
prepared	Подготовлен к отправке
submitted	Отправлен
rejected	Отклонен
accepted	Одобрен специалистом
suspected	Подозрительный вывод
processing	В обработке
pending	В ожидании обработки
queued	В очереди
succeed	Успешно выполнен
canceled	Отменен
failed	Не выполнен
review	На изучении
confirming	В стадии подтверждения
blocked	Заблокирован

Создать вывод коинов

Запустить вывод криптовалюты.

curl -X POST \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1769518579' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'address=https%3A%2F%2Fblockchair.com%2Flitecoin%2Faddress%2F1PHqrA7wnDrPwZ4tvaVa8Pjde9nJtb39AL&amount=5.5662&chain=ltc&currency=ltc' \
     'https://api.tokenspot.com/api/v1/withdraw/coin/create'

{
  "id": "834",
  "currency": "ltc",
  "amount": "5.5662",
  "fee": "0.0553",
  "address": "https://blockchair.com/litecoin/address/1PHqrA7wnDrPwZ4tvaVa8Pjde9nJtb39AL",
  "memo": "",
  "status": "submitted",
  "chain": "ltc",
  "txid": null,
  "block_number": null,
  "created_at": "2025-12-09T13:00:49Z",
  "updated_at": "2025-12-09T13:00:49Z",
  "completed_at": null
}

HTTP-запрос

POST https://api.tokenspot.com/api/v1/withdraw/coin/create

Query Параметры

Параметр	Описание	Обязательный
currency	Валюта	Да
chain	Сеть	Да
amount	Сумма	Да
address	Адрес пополнения	Да
memo	Memo	Нет

Структура Ответа

Параметр	Описание
id	Идентификатор вывода
currency	Валюта
amount	Сумма
fee	Комиссия
address	Адрес пополнения
memo	Memo
status	Статус вывода (см. статусы выводов)
chain	Сеть
txid	Идентификатор транзакции
block_number	Номер блока
created_at	Время создания
updated_at	Время последнего обновления
completed_at	Время завершения вывода

Комиссии за вывод коинов

Узнать комиссии за вывод криптовалюты

curl -X GET 'https://api.tokenspot.com/api/v1/withdraw/fees_crypto'

[
  {
    "currency": "trx",
    "min_amount": "0.348",
    "fee": [
      {
        "type": "fixed",
        "value": "0.2711"
      }
    ]
  },
  {
    "currency": "atom",
    "min_amount": "0.145",
    "fee": [
      {
        "type": "fixed",
        "value": "0.4221"
      }
    ]
  },
  {
    "currency": "avax",
    "min_amount": "0.179",
    "fee": [
      {
        "type": "fixed",
        "value": "0.0133"
      }
    ]
  },
  {
    "currency": "eth",
    "min_amount": "0.334",
    "fee": [
      {
        "type": "fixed",
        "value": "0.2467"
      }
    ]
  },
  {
    "currency": "usdt",
    "min_amount": "0.485",
    "fee": [
      {
        "type": "fixed",
        "value": "0.6459"
      }
    ]
  },
  {
    "currency": "zec",
    "min_amount": "0.806",
    "fee": [
      {
        "type": "fixed",
        "value": "0.4273"
      }
    ]
  },
  {
    "currency": "doge",
    "min_amount": "0.374",
    "fee": [
      {
        "type": "fixed",
        "value": "0.4107"
      }
    ]
  },
  {
    "currency": "sol",
    "min_amount": "0.959",
    "fee": [
      {
        "type": "fixed",
        "value": "0.8777"
      }
    ]
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/withdraw/fees_crypto

Структура Ответа

Параметр	Описание
currency	Валюта
min_amount	Минимальная сумма вывода
fee	Комиссия
type	Тип комиссии
value	Значение комисии

Информация о выводе

Получить свойства вывода

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/withdraw/info?id=2693'

{
  "id": "2693",
  "currency": "btc",
  "amount": "5.9106",
  "fee": "0.1889",
  "address": "https://www.blockchain.com/btc/address/1AFrcX9qJnjp3mmnB2ao1qTvaM2iFYdDzX",
  "memo": "",
  "status": "processing",
  "chain": "btc",
  "txid": null,
  "block_number": null,
  "created_at": "2025-10-04T15:16:50Z",
  "updated_at": "2025-10-04T15:16:50Z",
  "completed_at": null
}

HTTP-запрос

GET https://api.tokenspot.com/api/v1/withdraw/info

Query Параметры

Параметр	Описание	Обязательный
id	Идентификатор	Да

Структура Ответа

Параметр	Описание
id	Идентификатор вывода
currency	Валюта
amount	Сумма
fee	Комиссия
address	Адрес пополнения
memo	Memo
status	Статус вывода (см. статусы выводов)
chain	Сеть
txid	Идентификатор транзакции
block_number	Номер блока
created_at	Время создания
updated_at	Время последнего обновления
completed_at	Время завершения вывода

История выводов

Получить список ваших выводов

curl -X GET \
      --header 'Accept: application/json' \
      --header 'TS-API-API-KEY: <KEY_UID>' \
      --header 'TS-API-TIMESTAMP: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/withdraw/history?chain=ltc&currency=ltc'

[
  {
    "id": 9904,
    "currency": "ltc",
    "amount": "2.1999",
    "fee": "0.3878",
    "address": "https://blockchair.com/litecoin/address/16znpEqc87TtWnwgca6WndjjwRzKWGFGdD",
    "memo": "",
    "status": "rejected",
    "chain": "ltc",
    "txid": "6be07c084a45d8e0825b36f14a588f0ba788413ef093fc3944940b3c113de461",
    "block_number": null,
    "created_at": "2026-01-11T08:03:38Z",
    "updated_at": "2026-01-21T11:07:22Z",
    "completed_at": null
  },
  {
    "id": 9903,
    "currency": "ltc",
    "amount": "2.1999",
    "fee": "0.9779",
    "address": "https://blockchair.com/litecoin/address/16znpEqc87TtWnwgca6WndjjwRzKWGFGdD",
    "memo": "",
    "status": "rejected",
    "chain": "ltc",
    "txid": "6be07c084a45d8e0825b36f14a588f0ba788413ef093fc3944940b3c113de461",
    "block_number": null,
    "created_at": "2026-01-09T09:47:21Z",
    "updated_at": "2026-01-21T02:11:55Z",
    "completed_at": null
  },
  {
    "id": 2921,
    "currency": "ltc",
    "amount": "2.1999",
    "fee": "0.0644",
    "address": "https://blockchair.com/litecoin/address/16znpEqc87TtWnwgca6WndjjwRzKWGFGdD",
    "memo": "",
    "status": "rejected",
    "chain": "ltc",
    "txid": "6be07c084a45d8e0825b36f14a588f0ba788413ef093fc3944940b3c113de461",
    "block_number": null,
    "created_at": "2026-01-09T03:29:52Z",
    "updated_at": "2026-01-21T00:30:23Z",
    "completed_at": null
  }
]

HTTP-запрос

GET https://api.tokenspot.com/api/v1/withdraw/history

Query Параметры

Параметр	Значение по умолчанию	Описание	Обязательный
currency	null	Валюта	Нет, если не указан chain
chain	null	Сеть	Нет
state	null	Статус вывода (см. статусы выводов)	Нет
start_time	null	Время создания от (пагинация)	Нет
end_time	null	Время создания до (пагинация)	Нет
order_by	DESC	Сортировка по времени создания (ASC / DESC)	Нет
start_id	null	Начальный ID (пагинация)	Нет
end_id	null	Конечный ID (пагинация)	Нет
limit	100	Количество записей, не больше 1000	Нет

Структура Объекта

Параметр	Описание
id	Идентификатор вывода
currency	Валюта
amount	Сумма
fee	Комиссия
address	Адрес пополнения
memo	Memo
status	Статус вывода (см. статусы выводов)
chain	Сеть
txid	Идентификатор транзакции
block_number	Номер блока
created_at	Время создания
updated_at	Время последнего обновления
completed_at	Время завершения вывода

Системные данные

IP-адрес клиента

  curl -X GET --header 'Accept: application/json' 'https://api.tokenspot.com/api/v1/system/ip'

"53.125.62.209"

Получить ваш IP-адрес

HTTP-запрос

GET https://api.tokenspot.com/api/v1/system/ip

Серверное время

  curl -X GET --header 'Accept: application/json' 'https://api.tokenspot.com/api/v1/system/timestamp'

"2026-01-27T12:56:19+00:00"

Получить время сервера

HTTP-запрос

GET https://api.tokenspot.com/api/v1/system/timestamp

Рынки

Получить список торговых пар

  curl -X GET --header 'Accept: application/json' 'https://api.tokenspot.com/api/v1/markets'

[
  {
    "symbol": "filcny",
    "name": "FIL/CNY",
    "ask_unit": "fil",
    "bid_unit": "cny",
    "min_ask": 0.45518,
    "min_bid": 0.03184,
    "maker_fee": 0.3289,
    "taker_fee": 0.608
  },
  {
    "symbol": "filkhr",
    "name": "FIL/KHR",
    "ask_unit": "fil",
    "bid_unit": "khr",
    "min_ask": 0.04453,
    "min_bid": 0.25977,
    "maker_fee": 0.2566,
    "taker_fee": 0.558
  },
  {
    "symbol": "dashgyd",
    "name": "DASH/GYD",
    "ask_unit": "dash",
    "bid_unit": "gyd",
    "min_ask": 0.84008,
    "min_bid": 0.66339,
    "maker_fee": 0.3211,
    "taker_fee": 0.898
  },
  {
    "symbol": "bnbaed",
    "name": "BNB/AED",
    "ask_unit": "bnb",
    "bid_unit": "aed",
    "min_ask": 0.77026,
    "min_bid": 0.92774,
    "maker_fee": 0.7708,
    "taker_fee": 0.417
  },
  {
    "symbol": "maticaud",
    "name": "MATIC/AUD",
    "ask_unit": "matic",
    "bid_unit": "aud",
    "min_ask": 0.12176,
    "min_bid": 0.18442,
    "maker_fee": 0.2432,
    "taker_fee": 0.366
  },
  {
    "symbol": "bnbbyr",
    "name": "BNB/BYR",
    "ask_unit": "bnb",
    "bid_unit": "byr",
    "min_ask": 0.86667,
    "min_bid": 0.11808,
    "maker_fee": 0.8792,
    "taker_fee": 0.249
  },
  {
    "symbol": "tonxbb",
    "name": "TON/XBB",
    "ask_unit": "ton",
    "bid_unit": "xbb",
    "min_ask": 0.03215,
    "min_bid": 0.78476,
    "maker_fee": 0.6229,
    "taker_fee": 0.931
  },
  {
    "symbol": "dogeghs",
    "name": "DOGE/GHS",
    "ask_unit": "doge",
    "bid_unit": "ghs",
    "min_ask": 0.33866,
    "min_bid": 0.42743,
    "maker_fee": 0.6454,
    "taker_fee": 0.391
  }
]

Получить список торговых пар на спотовом рынке

HTTP-запрос

GET https://api.tokenspot.com/api/v1/markets

Структура Ответа

Параметр	Описание
symbol	Системный символ торговой пары
name	Название торговой пары
ask_unit	Валюта покупки
bid_unit	Валюта продажи
min_ask	Минимальная покупка
min_bid	Минимальная продажа
maker_fee	Комиссия продавца
taker_fee	Комиссия покупателя

Ошибки

Ответы API содержат стандартные HTTP-заголовки ошибок. Статья про HTTP-коды

{
  "error": {
    "code": "authorization.failed.error",
    "message": "Authorization failed: Expired TS-API-SIGN"
  }
}

Тело ответа содержат код логической ошибки:

Код Ошибки	Значение
`params.error`	Ошибка параметров запроса
`authorization.failed.error`	Ошибка авторизации
`withdraw.validation.error`	Ошибка валидации вывода средств
`create.withdraw.error`	Ошибка создания вывода
`deposit.validation.error`	Ошибка валидации пополнения
`create.deposit.error`	Ошибка создания пополнения
`deposit.code.validation.error`	Ошибка валидации кода вывода
`create.deposit.code.error`	Ошибка создания кода вывода
`redeem.deposit.code.error`	Ошибка применения кода
`create.order.error`	Ошибка создания заявки
`cancel.order.error`	Ошибка отмены заявки
`order.not.found.error`	Заявка не найдена
`create.order.account.error`	Ошибка создания заявки
`create.order.exchanger.error`	Ошибка создания заявки
`deposit.by.txid.not.found.error`	Пополнение по txid не найдено
`deposit.by.id.not.found.error`	Пополнение по id не найдено
`withdraw.by.id.not.found.error`	Вывод по id не найден
`deposit.address.by.id.not.found.error`	Адрес для по полнения по id не найден
`market.not.available`	Рынок недоступен
`validate.gt.params.error`	Ошибка параметров пагинации
`redeem.deposit.code.params.error`	Ошибка применения TokenSpot-кода
`deposit.code.by.id.not.found.error`	TokenSpot-код не найден по id
`deposit.code.by.id.already.used.error`	TokenSpot-код уже использован
`deposit.code.has.expired`	Срок TokenSpot-кода уже истек
`deposit.code.wrong.currency`	Неверная валюта для кода пополнения
`deposit.address.list.params.empty`	Для списка адресов для пополнения недостаточно параметров
`trading.disabled.for.account`	Торговля отключена для аккаунта
`dry.matching.error`	Торговля временно отключена
`client.order.id.duplicated`	Дубликат идентификатора клиента
`order.not.found.by.client.order.id.error`	Заявка по идентификатору клиента не найдена
`api.disabled.error`	API отключен
`api.key.does.not.have.withdraw.role.error`	API-ключ не имеет разрешения на выводы
`api.key.does.not.have.trading.role.error`	API-ключ не имеет разрешения на торговлю
`withdrawals.disabled.error`	Выводы отключены
`member.does.not.have.deposit.permissions`	Аккаунт не имеет разрешения на поплнения
`member.does.not.have.withdraw.permissions`	Аккаунт не имеет разрешения на выводы
`member.does.not.have.trading.permission`	Аккаунт не имеет разрешения на торговлю
`currency.not.found.by.key.and.chain.error`	Валюта не найдена по ключу и сети
`limit.order.wrong.arguments.error`	Неверные аргументы для лимитного ордера
`server.error`	Ошибка сервера

WebSocket API

WebSocket URL

Подключение к WebSocket осуществляется через единый интерфейс wss://ws.tokenspot.com. Каналы на которые необходима подписка следует указывать в Query string с параметром stream, например:

wss://ws.tokenspot.com/?stream=global&stream=dogeyer&stream=trading_ui_order_book&stream=ext_markets

Подписка на поток свечных данных (K-line)

WebSocket endpoint для получения данных свечей (K-line) с указанным интервалом для торговой пары.

/?stream=ethlkr-kline-1d');

ws.onmessage = (event) => { console.log(JSON.parse(event.data)); }; ``` %>

WebSocket URL

wss://ws.tokenspot.com/?stream={pair}-kline-{interval}

Параметры подключения

Параметр	Описание	Обязательный	Пример значения
pair	Идентификатор торговой пары	Да	`ethlkr`
interval	Интервал свечи	Да	`1m`, `5m`, `15m`, `1h`, `4h`, `1d`

Формат сообщения

При успешном подключении сервер начинает отправлять сообщения в формате:

{
  "{pair}-kline-{interval}.kline-{interval}": {
    "close": Float,
    "high": Float,
    "low": Float,
    "open": Float,
    "time": Integer,
    "volume": Float
  }
}

Структура данных свечи

Поле	Тип	Описание
close	Float	Цена закрытия свечи (последняя цена в интервале)
high	Float	Максимальная цена в интервале
low	Float	Минимальная цена в интервале
open	Float	Цена открытия свечи (первая цена в интервале)
time	Integer	Временная метка Unix (в секундах)
volume	Float	Объем торгов за интервал

{
  "ethlkr-kline-1d": {
    "close": 50.0,
    "high": 100.0,
    "low": 33.13,
    "open": 100.0,
    "time": 1769518579,
    "volume": 1.04
  }
}

Доступные интервалы

Интервал	Описание
1w	1 неделя
3d	3 дня
1d	1 день
12h	12 часов
6h	6 часов
4h	4 часа
2h	2 часа
1h	1 час
30m	30 минут
15m	15 минут
5m	5 минут
1m	1 минута

Особенности работы

Сервер не возвращает ошибку при:
- Неправильном названии торговой пары
- Неправильно указанном интервале
- Некорректном формате запроса
При неправильных параметрах подключения сервер может:
- Не устанавливать соединение
- Устанавливать соединение, но не отправлять данные
- Закрывать соединение без сообщения об ошибке
Частота обновления соответствует выбранному интервалу:
- Для 1m - обновление каждую минуту
- Для 5m - каждые 5 минут и т.д.

Примеры подключения:

Минутные данные для пары USDT/A7A5:

const ws = new WebSocket('wss://ws.tokenspot.com/?stream=usdta7a5-kline-1m');

Часовые данные для пары BTC/USDT:

const ws = new WebSocket('wss://ws.tokenspot.com/?stream=btcusdt-kline-1h');

Дневные данные для пары ETH/BTC:

const ws = new WebSocket('wss://ws.tokenspot.com/?stream=ethbtc-kline-1d');

Подписка на поток Стакан

WebSocket endpoint для получения данных стакана.

WebSocket URL

wss://ws.tokenspot.com/?stream=[market_id]

Формат сообщения orderbook

{
  "uninio.orderbook": {
    "ask": [
      {
        "id": 9792,
        "price": "85.0",
        "volume": "2879.4358",
        "amount": "244752.043",
        "factor": "0.7081",
        "rate_source": "",
        "rate_source_s": "",
        "type": "limit"
      },
      {
        "id": 7687,
        "price": "85.0",
        "volume": "3737.5005",
        "amount": "317687.5425",
        "factor": "0.5628",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 6118,
        "price": "89.7",
        "volume": "2812.8581",
        "amount": "252313.37157",
        "factor": "0.1464",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 5580,
        "price": "85.0",
        "volume": "7550.6024",
        "amount": "641801.204",
        "factor": "0.3929",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 4106,
        "price": "86.3",
        "volume": "6308.2308",
        "amount": "544400.31804",
        "factor": "0.2317",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 2540,
        "price": "85.0",
        "volume": "2711.8271",
        "amount": "230505.3035",
        "factor": "0.2271",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 2204,
        "price": "85.0",
        "volume": "2276.4053",
        "amount": "193494.45049999998",
        "factor": "0.9127",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 2193,
        "price": "85.0",
        "volume": "7439.9361",
        "amount": "632394.5684999999",
        "factor": "0.9428",
        "rate_source": "",
        "rate_source_s": "",
        "type": "limit"
      }
    ],
    "bid": [
      {
        "id": 9168,
        "price": "80.0",
        "volume": "1372.5647",
        "amount": "109805.17599999999",
        "factor": "-0.0824",
        "rate_source": "",
        "rate_source_s": "",
        "type": "limit"
      },
      {
        "id": 8043,
        "price": "80.0",
        "volume": "4449.3779",
        "amount": "355950.232",
        "factor": "-0.8704",
        "rate_source": "",
        "rate_source_s": "",
        "type": "limit"
      },
      {
        "id": 7724,
        "price": "80.0",
        "volume": "9874.7494",
        "amount": "789979.952",
        "factor": "-0.1886",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 7444,
        "price": "80.0",
        "volume": "4341.5684",
        "amount": "347325.472",
        "factor": "-0.9298",
        "rate_source": "",
        "rate_source_s": "",
        "type": "limit"
      },
      {
        "id": 7138,
        "price": "95.7",
        "volume": "9579.5741",
        "amount": "916765.2413700001",
        "factor": "-0.5157",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 6289,
        "price": "80.0",
        "volume": "7245.9913",
        "amount": "579679.304",
        "factor": "-0.9722",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      },
      {
        "id": 4002,
        "price": "90.8",
        "volume": "7338.2091",
        "amount": "666309.38628",
        "factor": "-0.0213",
        "rate_source": "",
        "rate_source_s": "",
        "type": "market"
      }
    ]
  }
}

Структура данных

Поле	Тип	Описание
amount	float	количество второй валюты в заявке
factor	float	отклонение от рыночной цены
id	integer	идентификатор заявки
price	float	цена заявки
rate_source	string	источник курса
rate_source_s	string	источник курса сокращённый
type	string	тип сделки
volume	float	объем заявки в основной валюте

Формат сообщения ticker

{
  "ethawg.ticker": {
    "low": "20.0",
    "high": "93.29",
    "last": "27.49",
    "rlast": "36.22",
    "at": 1769518579,
    "open": "40.47",
    "base_volume": "274.5",
    "quote_volume": "7716.4",
    "sell": "74.21",
    "buy": "20.0",
    "price_change_percent": "7.4512249658",
    "market_cap": 78829980468872.5
  }
}

Структура данных

Поле	Тип	Описание
low	float	Минимальная цена
high	float	Максимальная цена
last	float	Цена закрытия
rlast	float	Цена закрытия (с округлением)
at	integer	Дата и время в момент сбора данных (Unixtime seconds)
open	float	Цена открытия
base_volume	float	Объем торгов в базовой валюте
quote_volume	float	Объем торгов в котируемой валюте
sell	float	Лучшая цена продажи
buy	float	Лучшая цена покупки
price_change_percent	float	изменение цены относительно предыдущего тикера
market_cap	float	Капитализация

Подписка на поток сделок

WebSocket endpoint для получения сделок.

WebSocket URL

wss://ws.tokenspot.com/?stream=ext_markets

Формат сообщения ext trades

{
  "ext_markets.trades": {
    "trades": [
      {
        "tid": 298246,
        "market": "trxmnt",
        "type": "sell",
        "date": 1769422723,
        "amount": "3737.69",
        "price": "44.05",
        "volume": "9864.9265",
        "ask": "trx",
        "bid": "mnt"
      }
    ]
  }
}

Структура данных

Поле	Тип	Описание
tid	integer	идентификатор сделки
market	string	название рынка
type	string	тип сделки (покупка/продажа)
date	integer	Дата
amount	float	Стоимость сделки
price	float	Цена единицы (ask/bid)
volume	float	Объем сделки
ask	string	Валюта
bid	string	Валюта