Введение
Документация описывает работу с TokenSpot REST API. Используйте этот API для интеграции TokenSpot с вашими приложениями.
Авторизация
Пример прохождения авторизации:
#!/bin/bash
KEY_UID=key
API_KEY_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}${KEY_UID}${RECV_WINDOW}${PAYLOAD}"
SIGNATURE=$(echo -n "$STRING_TO_SIGN" | openssl dgst -sha256 -hmac "$API_KEY_SECRET" | sed 's/^.* //')
echo "${BASE_URL}${ENDPOINT}?${QUERY}"
echo "TS-API-API-KEY: ${KEY_UID}"
echo "TS-API-TIMESTAMP: ${TIMESTAMP}"
echo "TS-API-RECV-WINDOW: ${RECV_WINDOW}"
echo "TS-API-SIGN: ${SIGNATURE}"
# Собираем заголовки в массив
headers=(
-H "TS-API-API-KEY: ${KEY_UID}"
-H "TS-API-TIMESTAMP: ${TIMESTAMP}"
-H "TS-API-RECV-WINDOW: ${RECV_WINDOW}"
-H "TS-API-SIGN: ${SIGNATURE}"
)
# Выполняем запрос
curl -X $METHOD "${BASE_URL}${ENDPOINT}?${QUERY}" "${headers[@]}"
echo
Часть эндпоинтов API публичные, они не требуют авторизации пользователя. Для авторизации в приватных эндпоинтах необходимо создать API-ключ в интерфейсе биржи. Ключ используется для генерации подписи к каждому запросу:
DATA = TIMESTAMP + KEY_UID + RECV_WINDOW + PAYLOAD
SIGN = HMAC-SHA256(DATA, API_KEY_SECRET)
Где:
- 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.
Скачать форму генерации подписи
Аккаунт
Данные API-ключа
Получить свойства вашего API-ключа
curl -X GET \
--header 'Accept: application/json' \
--header 'TS-API-API-KEY: <KEY_UID>' \
--header 'TS-API-TIMESTAMP: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/account/api_key?uid=<KEY_UID>'
Пример ответа:
{
"uid": "6da17d-633b3b-e33dc8-8ad384-8519d2",
"name": "Flowdesk-Cardify-4795",
"network_mask": "236.116.158.120/14,45eb:63d:acce:564d:5c2d:e741:4e7d:f482/100",
"trading_permitted": true,
"withdrawals_permitted": false,
"p2p_permitted": true
}
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/account/info'
Пример ответа:
{
"uid": "IDC65EE417A7400D",
"email": "murray.abbott@wisozk-collins.name",
"nickname": "Billy",
"balances": [
{
"currency": "xmr",
"balance": 41557.7182,
"locked": 45794.5334,
"order_locked": 35590.9021,
"withdraw_locked": 91074.7327,
"p2p_locked": 33884.2752,
"credit_limit": 20837.7015,
"available_to_withdraw": 33170.7247,
"credit_usage_fee": 55303.0345,
"credit_overdue_fee": 42874.9265
},
{
"currency": "ron",
"balance": 32926.5363,
"locked": 97997.7094,
"order_locked": 53281.9314,
"withdraw_locked": 94784.1492,
"p2p_locked": 14879.4705,
"credit_limit": 81830.9406,
"available_to_withdraw": 28118.4158,
"credit_usage_fee": 67718.9309,
"credit_overdue_fee": 16864.3893
},
{
"currency": "dash",
"balance": 69447.8315,
"locked": 13892.0917,
"order_locked": 38081.3679,
"withdraw_locked": 85501.6435,
"p2p_locked": 35518.0433,
"credit_limit": 49594.4835,
"available_to_withdraw": 14539.0442,
"credit_usage_fee": 14532.4828,
"credit_overdue_fee": 94223.1771
}
],
"trading_permitted": true,
"withdrawals_permitted": true,
"p2p_permitted": true,
"fiat_withdrawals_permitted": true,
"coin_withdrawals_permitted": true
}
HTTP-запрос
GET https://api.tokenspot.com/api/v1/account/info
Структура Ответа
| Параметр | Описание |
|---|---|
| uid | Идентификатор аккаунта |
| Email аккаунта | |
| nickname | Никнейм |
| balances | Балансы аккаунта |
| trading_permitted | Разрешение на торги |
| withdrawals_permitted | Разрешение на вывод средств |
| p2p_permitted | Разрешение на P2P |
| coin_withdrawals_permitted | Разрешение на вывод средств в крипто валюте |
| fiat_withdrawals_permitted | Разрешение на вывод средств в фиатной валюте |
Структура Баланса
| Параметр | Описание |
|---|---|
| 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=nok&direction=deposit'
Пример ответа:
[
{
"id": 5855,
"direction": "deposit",
"currency": "nok",
"title": "Банковский перевод (Банк Зенит)",
"description": "...",
"instructions": "...",
"min_amount": 80337.2594,
"max_amount": 74286.4909,
"rounding": "0.0001",
"fee": 78364.7644,
"fee_fixed": 71571.5112,
"fee_limit": 82173.4544
},
{
"id": 3205,
"direction": "deposit",
"currency": "nok",
"title": "Наличные (Ульяновск)",
"description": "...",
"instructions": "...",
"min_amount": 29940.6718,
"max_amount": 42308.9837,
"rounding": "0.0001",
"fee": 73700.4218,
"fee_fixed": 87775.2412,
"fee_limit": 57596.0226
}
]
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": "xmr",
"symbol": "ɱ",
"chains": [
{
"withdraw_fee": 0.1737,
"title": "xmr",
"deposit_status": "allowed",
"deposit_status_description": "",
"withdraw_status": "allowed",
"withdraw_status_description": "",
"blockchain": "xmr",
"min_deposit_amount": 0.4897,
"min_withdraw_amount": 0.3491
}
],
"type": "coin",
"precision": 4
},
{
"id": "fil",
"symbol": "Ϝ",
"chains": [
{
"withdraw_fee": 0.0464,
"title": "fil",
"deposit_status": "allowed",
"deposit_status_description": "",
"withdraw_status": "allowed",
"withdraw_status_description": "",
"blockchain": "fil",
"min_deposit_amount": 0.7984,
"min_withdraw_amount": 0.2038
}
],
"type": "coin",
"precision": 4
},
{
"id": "uni",
"symbol": "🦄",
"chains": [
{
"withdraw_fee": 0.4073,
"title": "uni",
"deposit_status": "allowed",
"deposit_status_description": "",
"withdraw_status": "allowed",
"withdraw_status_description": "",
"blockchain": "uni",
"min_deposit_amount": 0.1824,
"min_withdraw_amount": 0.3458
}
],
"type": "coin",
"precision": 4
},
{
"id": "atom",
"symbol": "⚛",
"chains": [
{
"withdraw_fee": 0.3871,
"title": "atom",
"deposit_status": "allowed",
"deposit_status_description": "",
"withdraw_status": "allowed",
"withdraw_status_description": "",
"blockchain": "atom",
"min_deposit_amount": 0.0931,
"min_withdraw_amount": 0.7669
}
],
"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": "ada",
"explorer_transaction": "https://cardanoscan.io/transaction/7193878b514f2aad1f90acf9a47d7f3b35166cee608845f1b1c683c204407398",
"explorer_address": "https://cardanoscan.io/address/1B2zAgR8h5HUQTx49J4rGtWxReknpvFhSE",
"min_confirmations": 6,
"hold_timeout_minutes": 80
},
{
"key": "bch",
"explorer_transaction": "https://blockchair.com/bitcoin-cash/transaction/1b2e8f4707cc2cbb7136dd3512258e4a1bb109740de1ba54cef936ece0046817",
"explorer_address": "https://blockchair.com/bitcoin-cash/address/157CWgTurirT82BZXuzZnJf7qkcMfwPf1U",
"min_confirmations": 9,
"hold_timeout_minutes": 69
},
{
"key": "btc",
"explorer_transaction": "https://www.blockchain.com/btc/tx/6c4f1345d2597c8f53d7d8f4faa76e006c21c8cb4c53eb60b8d27e3ff3bfaba5",
"explorer_address": "https://www.blockchain.com/btc/address/12PxcZL4Z4szJU5rbmxvZyFfWR6scG1j4p",
"min_confirmations": 5,
"hold_timeout_minutes": 43
},
{
"key": "xrp",
"explorer_transaction": "https://xrpscan.com/tx/70f76553886c836b007d82927bc0d325805849a795fecb60acb9e0f15f049d4e",
"explorer_address": "https://xrpscan.com/account/18P68tgmyA2z3g3xz7dWyNnQu4KjjbckSy",
"min_confirmations": 9,
"hold_timeout_minutes": 88
},
{
"key": "ltc",
"explorer_transaction": "https://blockchair.com/litecoin/transaction/913cf2c358408349bfb9615301643be3e61e9bdc9b354670565132b7b0b5df1d",
"explorer_address": "https://blockchair.com/litecoin/address/1H1zB9VFhGX4CkRLvednGeVuDrU1MQwzB4",
"min_confirmations": 7,
"hold_timeout_minutes": 42
},
{
"key": "trx",
"explorer_transaction": "https://tronscan.org/#/transaction/39cda49cfecb2145c60f2e119c6eb9407f83fb3e2388ab333d3d68ed3f4273a2",
"explorer_address": "https://tronscan.org/#/address/16TboaGGstuizcHq6baLp8B8wVoi3Gnk7p",
"min_confirmations": 2,
"hold_timeout_minutes": 16
}
]
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.5471",
"title": "doge",
"deposit_status": "allowed",
"deposit_status_description": "",
"withdraw_status": "allowed",
"withdraw_status_description": "",
"blockchain": "doge",
"min_deposit_amount": "0.2539",
"min_withdraw_amount": "0.3755"
}
],
"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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/asset/balance_list'
Пример ответа:
[
{
"currency": "aed",
"balance": "1699.6569",
"locked": "4.9237",
"order_locked": "0.9724",
"withdraw_locked": "7.0063",
"p2p_locked": "0.3788",
"credit_limit": "16523.6",
"available_to_withdraw": "42878.0745",
"credit_usage_fee": "0.4969",
"credit_overdue_fee": "0.1223"
},
{
"currency": "bmd",
"balance": "2696.7081",
"locked": "2.2869",
"order_locked": "0.0344",
"withdraw_locked": "6.7083",
"p2p_locked": "0.2698",
"credit_limit": "22063.1",
"available_to_withdraw": "56843.6457",
"credit_usage_fee": "0.3475",
"credit_overdue_fee": "0.8704"
},
{
"currency": "mxn",
"balance": "7685.4087",
"locked": "5.4511",
"order_locked": "0.6263",
"withdraw_locked": "8.9347",
"p2p_locked": "0.9165",
"credit_limit": "55421.5",
"available_to_withdraw": "29649.7717",
"credit_usage_fee": "0.2204",
"credit_overdue_fee": "0.2539"
},
{
"currency": "usdt",
"balance": "5906.1821",
"locked": "5.8453",
"order_locked": "0.7136",
"withdraw_locked": "5.9555",
"p2p_locked": "0.9802",
"credit_limit": "39727.7",
"available_to_withdraw": "98242.5745",
"credit_usage_fee": "0.4938",
"credit_overdue_fee": "0.4165"
}
]
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/asset/balance?currency=btc'
Пример ответа:
{
"currency": "btc",
"balance": "7440.1116",
"locked": "2.9717",
"order_locked": "0.8922",
"withdraw_locked": "1.7868",
"p2p_locked": "0.7698",
"credit_limit": "76286.1",
"available_to_withdraw": "30550.2703",
"credit_usage_fee": "0.1365",
"credit_overdue_fee": "0.3101"
}
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=dogekpw'
Пример ответа:
[
{
"id": 9,
"price": "378.6",
"amount": "530.92",
"total": "712.5",
"symbol": "atomtzs",
"created_at": "2026-06-05T03:55:49Z"
},
{
"id": 7,
"price": "821.5",
"amount": "620.74",
"total": "862.4",
"symbol": "xrplyd",
"created_at": "2026-06-04T07:40:20Z"
},
{
"id": 2,
"price": "951.8",
"amount": "177.81",
"total": "809.8",
"symbol": "dogemyr",
"created_at": "2026-04-26T22:28:03Z"
}
]
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=ethchf'
Пример ответа:
[
{
"id": "11",
"price": "526.7",
"amount": "719.09",
"total": "806.8",
"symbol": "ethchf",
"created_at": "2026-06-09T22:54:15Z",
"hid": "399528",
"side": "sell"
},
{
"id": "10",
"price": "222.9",
"amount": "624.12",
"total": "852.8",
"symbol": "ethchf",
"created_at": "2026-05-30T11:20:36Z",
"hid": "420806",
"side": "buy"
},
{
"id": "9",
"price": "228.6",
"amount": "558.39",
"total": "595.9",
"symbol": "ethchf",
"created_at": "2026-05-26T21:09:54Z",
"hid": "668423",
"side": "buy"
},
{
"id": "8",
"price": "436.5",
"amount": "987.19",
"total": "736.8",
"symbol": "ethchf",
"created_at": "2026-04-30T08:09:29Z",
"hid": "806653",
"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=>"dashhtg"}
curl -X GET 'https://api.tokenspot.com/api/v1/spot/depth?symbol=dashhtg'
Пример ответа:
{
"timestamp": 1781098253,
"asks": [
{
"price": "829632.57",
"volume": "0.454381",
"amount": "5055161.69"
},
{
"price": "408254.08",
"volume": "0.575838",
"amount": "6710290.93"
}
],
"bids": [
{
"price": "120630.07",
"volume": "0.823866",
"amount": "7172845.97"
},
{
"price": "901206.52",
"volume": "0.152427",
"amount": "8570928.08"
}
]
}
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=73&period=60&symbol=solscr'
Пример ответа:
{
"k": {
"close": 742155.54,
"high": 730424.19,
"low": 558010.91,
"open": 854007.79,
"time": 1781019649,
"volume": 7
},
"trades": [
{
"tid": 8,
"market": "solscr",
"type": "sell",
"date": 1781098200,
"amount": "59.32",
"price": "61805.99",
"volume": "0.255902",
"ask": "sol",
"bid": "scr"
},
{
"tid": 7,
"market": "solscr",
"type": "sell",
"date": 1781098199,
"amount": "55.67",
"price": "93799.01",
"volume": "0.442309",
"ask": "sol",
"bid": "scr"
},
{
"tid": 6,
"market": "solscr",
"type": "buy",
"date": 1781098198,
"amount": "64.46",
"price": "93723.77",
"volume": "0.746482",
"ask": "sol",
"bid": "scr"
},
{
"tid": 5,
"market": "solscr",
"type": "buy",
"date": 1781098197,
"amount": "78.74",
"price": "36765.41",
"volume": "0.557022",
"ask": "sol",
"bid": "scr"
},
{
"tid": 4,
"market": "solscr",
"type": "buy",
"date": 1781098196,
"amount": "46.68",
"price": "16606.65",
"volume": "0.396592",
"ask": "sol",
"bid": "scr"
},
{
"tid": 3,
"market": "solscr",
"type": "sell",
"date": 1781098195,
"amount": "25.11",
"price": "40286.57",
"volume": "0.097251",
"ask": "sol",
"bid": "scr"
},
{
"tid": 2,
"market": "solscr",
"type": "sell",
"date": 1781098194,
"amount": "83.61",
"price": "58732.66",
"volume": "0.096724",
"ask": "sol",
"bid": "scr"
},
{
"tid": 1,
"market": "solscr",
"type": "sell",
"date": 1781098193,
"amount": "57.14",
"price": "38502.37",
"volume": "0.649784",
"ask": "sol",
"bid": "scr"
}
]
}
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=15&symbol=dashdop'
Пример ответа:
[
{
"close": 660309.18,
"high": 540946.33,
"low": 166858.05,
"open": 494192.23,
"time": 1781098230,
"volume": 2
},
{
"close": 542552.81,
"high": 736139.62,
"low": 308448.51,
"open": 986989.84,
"time": 1781098189,
"volume": 7
},
{
"close": 641323.67,
"high": 948673.67,
"low": 415030.13,
"open": 320273.15,
"time": 1781097859,
"volume": 9
},
{
"close": 519486.53,
"high": 200713.89,
"low": 942072.29,
"open": 156876.04,
"time": 1781097730,
"volume": 7
},
{
"close": 567388.82,
"high": 294416.13,
"low": 720277.66,
"open": 590065.56,
"time": 1781097724,
"volume": 7
},
{
"close": 678281.27,
"high": 671681.45,
"low": 608636.31,
"open": 589703.62,
"time": 1781097615,
"volume": 7
}
]
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/spot/my_trades'
Пример ответа:
[
{
"id": "10",
"order_id": 9,
"symbol": "btcxcd",
"is_maker": true,
"price": "6546.5",
"amount": "0.86",
"total": "177.01",
"fee": "0.348",
"fee_size": "4.49",
"created_at": "2026-05-24T15:32:15Z",
"side": "sell"
},
{
"id": "9",
"order_id": 3,
"symbol": "neopen",
"is_maker": true,
"price": "2026.9",
"amount": "0.46",
"total": "616.85",
"fee": "0.126",
"fee_size": "7.94",
"created_at": "2026-04-30T21:00:38Z",
"side": "sell"
},
{
"id": "8",
"order_id": 8,
"symbol": "zecgyd",
"is_maker": false,
"price": "9321.6",
"amount": "0.26",
"total": "574.95",
"fee": "0.247",
"fee_size": "8.86",
"created_at": "2026-02-27T23:18:19Z",
"side": "sell"
}
]
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
-d 'client_order_id=7055855&price=712&side=buy&symbol=solisk&type=limit&volume=4&volume_unit=base' \
'https://api.tokenspot.com/api/v1/spot/order'
Пример ответа:
{
"id": "468",
"client_order_id": "7055855",
"symbol": "solisk",
"remaining_volume": "9.4",
"executed_volume": "0.8",
"volume": 4,
"side": "buy",
"type": "limit",
"status": "partially_filled",
"price": 712,
"funds_received": "0.5",
"funds_fee": "0.3",
"trades_count": 6,
"avg_price": 1,
"executed_amount": "0.7",
"quote_amount": "0.1",
"created_at": "2025-10-16T12:48:34Z",
"updated_at": "2025-10-16T12:48:34Z"
}
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/spot/order_info?id=605'
Пример ответа:
{
"id": "605",
"client_order_id": "1893",
"symbol": "neowst",
"remaining_volume": "4.5",
"executed_volume": "0.8",
"volume": "1.6",
"side": "bid",
"type": "limit",
"status": "partially_filled",
"price": "4.8",
"funds_received": "0.4",
"funds_fee": "0.8",
"trades_count": 7,
"avg_price": 4,
"executed_amount": "0.1",
"quote_amount": "0.8",
"created_at": "2026-01-29T10:28:13Z",
"updated_at": "2026-01-29T10:28:13Z"
}
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
-d '{:id=>"4766"}' \
'https://api.tokenspot.com/api/v1/spot/cancel_order'
Пример ответа:
{
"id": "4766",
"client_order_id": "4351316",
"symbol": "dashtmt",
"remaining_volume": "2.4",
"executed_volume": "0.3",
"volume": "2.2",
"side": "ask",
"type": "market",
"status": "cancel",
"price": "9.4",
"funds_received": "0.2",
"funds_fee": "0.1",
"trades_count": 7,
"avg_price": 6,
"executed_amount": "0.3",
"quote_amount": "0.7",
"created_at": "2025-08-21T10:24:10Z",
"updated_at": "2026-06-06T02:14:21Z"
}
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": "973",
"client_order_id": "9377053",
"symbol": "ltcxbc",
"remaining_volume": "7.4",
"executed_volume": "0.4",
"volume": "5.1",
"side": "ask",
"type": "limit",
"status": "cancel",
"price": "4.6",
"funds_received": "0.6",
"funds_fee": "0.8",
"trades_count": 2,
"avg_price": 6,
"executed_amount": "0.2",
"quote_amount": "0.1",
"created_at": "2026-05-14T07:29:53Z",
"updated_at": "2026-06-07T15:47:13Z"
},
{
"id": "907",
"client_order_id": "7307930",
"symbol": "ltcscr",
"remaining_volume": "0.4",
"executed_volume": "0.8",
"volume": "1.7",
"side": "ask",
"type": "market",
"status": "cancel",
"price": "5.2",
"funds_received": "0.6",
"funds_fee": "0.2",
"trades_count": 6,
"avg_price": 3,
"executed_amount": "0.1",
"quote_amount": "0.3",
"created_at": "2026-05-02T11:09:47Z",
"updated_at": "2026-06-07T00:05:54Z"
},
{
"id": "897",
"client_order_id": "9597537",
"symbol": "tonmop",
"remaining_volume": "0.8",
"executed_volume": "0.8",
"volume": "6.4",
"side": "bid",
"type": "limit",
"status": "cancel",
"price": "4.1",
"funds_received": "0.5",
"funds_fee": "0.6",
"trades_count": 8,
"avg_price": 2,
"executed_amount": "0.3",
"quote_amount": "0.5",
"created_at": "2026-04-24T15:26:37Z",
"updated_at": "2026-06-06T10:26:27Z"
},
{
"id": "640",
"client_order_id": "8818482",
"symbol": "unikrw",
"remaining_volume": "8.4",
"executed_volume": "0.7",
"volume": "6.4",
"side": "ask",
"type": "market",
"status": "cancel",
"price": "5.2",
"funds_received": "0.2",
"funds_fee": "0.7",
"trades_count": 1,
"avg_price": 5,
"executed_amount": "0.7",
"quote_amount": "0.7",
"created_at": "2026-03-30T00:58:20Z",
"updated_at": "2026-06-05T16:48:00Z"
}
]
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/spot/order_history?symbol=bnbbnd'
Пример ответа:
[
{
"id": "966",
"client_order_id": "2652",
"symbol": "bnbbnd",
"remaining_volume": "6.9",
"executed_volume": "0.7",
"volume": "2.4",
"side": "ask",
"type": "limit",
"status": "filled",
"price": "8.9",
"funds_received": "0.6",
"funds_fee": "0.3",
"trades_count": 5,
"avg_price": 6,
"executed_amount": "0.2",
"quote_amount": "0.4",
"created_at": "2026-06-10T13:07:36Z",
"updated_at": "2026-05-25T22:08:50Z"
},
{
"id": "951",
"client_order_id": "4292",
"symbol": "bnbbnd",
"remaining_volume": "6.7",
"executed_volume": "0.3",
"volume": "7.1",
"side": "ask",
"type": "market",
"status": "new",
"price": "1.5",
"funds_received": "0.1",
"funds_fee": "0.6",
"trades_count": 5,
"avg_price": 8,
"executed_amount": "0.3",
"quote_amount": "0.1",
"created_at": "2026-06-10T12:53:38Z",
"updated_at": "2026-05-03T16:10:58Z"
},
{
"id": "888",
"client_order_id": "3676",
"symbol": "bnbbnd",
"remaining_volume": "6.5",
"executed_volume": "0.1",
"volume": "3.6",
"side": "bid",
"type": "limit",
"status": "new",
"price": "6.5",
"funds_received": "0.7",
"funds_fee": "0.3",
"trades_count": 4,
"avg_price": 4,
"executed_amount": "0.3",
"quote_amount": "0.9",
"created_at": "2026-06-09T04:48:37Z",
"updated_at": "2026-04-26T09:15:06Z"
},
{
"id": "788",
"client_order_id": "3724",
"symbol": "bnbbnd",
"remaining_volume": "5.7",
"executed_volume": "0.4",
"volume": "3.9",
"side": "bid",
"type": "market",
"status": "filled",
"price": "9.6",
"funds_received": "0.2",
"funds_fee": "0.3",
"trades_count": 6,
"avg_price": 3,
"executed_amount": "0.6",
"quote_amount": "0.3",
"created_at": "2026-06-08T00:59:47Z",
"updated_at": "2026-04-22T04:06:39Z"
},
{
"id": "334",
"client_order_id": "3405",
"symbol": "bnbbnd",
"remaining_volume": "8.8",
"executed_volume": "0.1",
"volume": "1.5",
"side": "bid",
"type": "limit",
"status": "partially_filled",
"price": "5.6",
"funds_received": "0.1",
"funds_fee": "0.3",
"trades_count": 5,
"avg_price": 1,
"executed_amount": "0.2",
"quote_amount": "0.9",
"created_at": "2026-06-05T04:19:35Z",
"updated_at": "2026-04-07T08:45: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": "mga",
"withdraw_fee": "0.549",
"deposit_fee": "0.152"
},
{
"currency": "zmk",
"withdraw_fee": "0.484",
"deposit_fee": "0.673"
},
{
"currency": "bob",
"withdraw_fee": "0.459",
"deposit_fee": "0.176"
},
{
"currency": "mur",
"withdraw_fee": "0.487",
"deposit_fee": "0.394"
}
]
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=20.4992&client_id=63778697127¤cy=huf' \
'https://api.tokenspot.com/api/v1/code/create'
Пример ответа:
{
"id": "9953C49B0102404762889533463E5836D5678E3BE35DBABB1741D8176DA6C77ADDE49A984EA621CEB1BA",
"code": "DGRKVEIALYOWBQMJCFSZ",
"client_id": "63778697127",
"currency": "huf",
"amount": "20.4992",
"used": false,
"fee": "6.836",
"created_at": "2025-09-03T05:24:32Z",
"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 | Использован ли код |
| fee | Комиссия |
| 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": "A66CC82B957BDE15760B51E5CC70395B945747EBB8BC84341BCAEE25496DD84E62D2C1473DDE95885A90",
"code": "123123123",
"client_id": "35545718310",
"currency": "ghs",
"amount": "3.7",
"used": true,
"fee": "0.854",
"created_at": "2025-10-03T07:07:35Z",
"used_at": "2025-09-12T20:42:36Z"
}
HTTP-запрос
POST https://api.tokenspot.com/api/v1/code/deposit
Query Параметры
| Параметр | Описание | Обязательный |
|---|---|---|
| code | Код | Да |
Структура Ответа
| Параметр | Описание |
|---|---|
| id | Идентификатор |
| code | Код (отображается полностью) |
| client_id | ID клиента |
| currency | Валюта кода |
| amount | Сумма |
| used | Использован ли код |
| fee | Комиссия |
| 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": "FIZRM***************",
"client_id": "54110311188",
"currency": "iqd",
"amount": "4.9",
"used": true,
"created_at": "2026-03-08T22:14:05Z",
"used_at": "2026-05-01T23:40:25Z"
}
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": "WUKVT***************",
"client_id": "16203180663",
"currency": "xba",
"amount": "4.9",
"used": false,
"fee": "0.273",
"created_at": "2025-12-26T01:09:12Z",
"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": "0E43CB7746C917E4BE10E9D235CD5095CA36DE65E4DEDBECB5B2C7ACC9BB1205411905588C5D3C74657B",
"code": "NQVDY***************",
"client_id": "68663802708",
"currency": "pen",
"amount": "9.5",
"used": true,
"fee": "0.291",
"created_at": "2026-01-30T23:49:39Z",
"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=dot¤cy=dot' \
'https://api.tokenspot.com/api/v1/deposit_address/create'
Пример ответа:
{
"id": 2403,
"address": "https://polkascan.io/polkadot/account/1B5WaJiiTBVy1a73qereaAqZhk5sfD23a1",
"blockchain": "dot",
"created_at": "2025-11-13T02:39:25Z",
"currency": "dot"
}
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=3372'
Пример ответа:
{
"id": 3372,
"address": "https://dogechain.info/address/16RcyUi6esGb8MssdaR7oYUbCu6Eq2hhYG",
"blockchain": "doge",
"created_at": "2025-11-28T03:47:26Z",
"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=ltc¤cy=ltc'
Пример ответа:
[
{
"id": 9079,
"address": "https://blockchair.com/litecoin/address/155Q1Kw3jdgN1kWBZWNnzqCuVoLr8bmXyn",
"blockchain": "ltc",
"created_at": "2026-06-07T12:14:13Z",
"currency": "ltc"
},
{
"id": 4857,
"address": "https://blockchair.com/litecoin/address/155Q1Kw3jdgN1kWBZWNnzqCuVoLr8bmXyn",
"blockchain": "ltc",
"created_at": "2026-06-03T10:12:38Z",
"currency": "ltc"
}
]
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=xrp¤cy=xrp'
Пример ответа:
{
"id": 5702,
"address": "https://xrpscan.com/account/1DConTEtVNj3hqngbNB1efZgAeak9cMrzR",
"blockchain": "xrp",
"created_at": "2025-07-02T11:48:30Z",
"currency": "xrp"
}
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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/deposit/history?currency=currency=eth&status=rejected'
Пример ответа:
[
{
"id": "876621",
"currency": "eth",
"type": "coin",
"amount": "41.21",
"fee": "0.02",
"txid": "491521",
"block_number": null,
"confirmations": null,
"status": "rejected",
"chain": "ethereum",
"address": "https://etherscan.io/address/0x9e9b63e00c91698ce67b43fcb7e28582e5171b05",
"created_at": "2026-06-03T08:18:12Z",
"completed_at": null,
"gateway_type": null
},
{
"id": "790925",
"currency": "eth",
"type": "coin",
"amount": "95.12",
"fee": "0.26",
"txid": "740809",
"block_number": null,
"confirmations": null,
"status": "rejected",
"chain": "ethereum",
"address": "https://etherscan.io/address/0x9e9b63e00c91698ce67b43fcb7e28582e5171b05",
"created_at": "2026-05-30T00:42:32Z",
"completed_at": null,
"gateway_type": null
},
{
"id": "742450",
"currency": "eth",
"type": "coin",
"amount": "16.61",
"fee": "0.69",
"txid": "889696",
"block_number": null,
"confirmations": null,
"status": "rejected",
"chain": "ethereum",
"address": "https://etherscan.io/address/0x9e9b63e00c91698ce67b43fcb7e28582e5171b05",
"created_at": "2026-05-03T13:02:16Z",
"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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
'https://api.tokenspot.com/api/v1/deposit/info?txid=574544'
Пример ответа:
{
"id": "891441",
"currency": "ton",
"type": "coin",
"amount": "78.67",
"fee": "0.45",
"txid": "574544",
"block_number": null,
"confirmations": null,
"status": "submitted",
"chain": "ton",
"address": "https://tonscan.org/address/1My6quwtSd9NexVQKt8JZHkHgSvvgiRX2p",
"created_at": "2025-12-31T12:38:14Z",
"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: 1781098253' \
--header 'TS-API-RECV-WINDOW: 100000' \
--header 'TS-API-SIGN: <SIGN>' \
-d 'address=https%3A%2F%2Fblockchair.com%2Fbitcoin-cash%2Faddress%2F1A8RsXMEGa3Kwun9UEDhn2G1UyBteyfqN7&amount=3.6368&chain=bch¤cy=bch' \
'https://api.tokenspot.com/api/v1/withdraw/coin/create'
Пример ответа:
{
"id": "161",
"currency": "bch",
"amount": "3.6368",
"fee": "0.4059",
"address": "https://blockchair.com/bitcoin-cash/address/1A8RsXMEGa3Kwun9UEDhn2G1UyBteyfqN7",
"memo": "",
"status": "submitted",
"chain": "bch",
"txid": null,
"block_number": null,
"created_at": "2026-05-07T05:23:26Z",
"updated_at": "2026-05-07T05:23:26Z",
"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": "doge",
"min_amount": "0.675",
"fee": [
{
"type": "fixed",
"value": "0.1283"
}
]
},
{
"currency": "avax",
"min_amount": "0.712",
"fee": [
{
"type": "fixed",
"value": "0.2542"
}
]
},
{
"currency": "neo",
"min_amount": "0.361",
"fee": [
{
"type": "fixed",
"value": "0.5695"
}
]
},
{
"currency": "uni",
"min_amount": "0.167",
"fee": [
{
"type": "fixed",
"value": "0.8679"
}
]
}
]
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=4246'
Пример ответа:
{
"id": "4246",
"currency": "eth",
"amount": "7.4407",
"fee": "0.7863",
"address": "https://etherscan.io/address/0x4f31342b8ed80a603317607a31918fa73049250d",
"memo": "",
"status": "suspected",
"chain": "ethereum",
"txid": null,
"block_number": null,
"created_at": "2026-05-04T23:05:35Z",
"updated_at": "2026-05-04T23:05:35Z",
"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=dot¤cy=dot'
Пример ответа:
[
{
"id": 9263,
"currency": "dot",
"amount": "7.1227",
"fee": "0.3513",
"address": "https://polkascan.io/polkadot/account/1DHydtVZhFyD349P26ii1Bwasb48u8R5oT",
"memo": "",
"status": "succeed",
"chain": "dot",
"txid": "84d5a88fd90fd1ce8f07defacfe97f6cb9f86d15af08e33a87c2b84610788615",
"block_number": 188290,
"created_at": "2026-05-26T13:27:44Z",
"updated_at": "2026-06-04T13:18:57Z",
"completed_at": "2026-06-10T11:25:38Z"
},
{
"id": 7536,
"currency": "dot",
"amount": "7.1227",
"fee": "0.7624",
"address": "https://polkascan.io/polkadot/account/1DHydtVZhFyD349P26ii1Bwasb48u8R5oT",
"memo": "",
"status": "succeed",
"chain": "dot",
"txid": "84d5a88fd90fd1ce8f07defacfe97f6cb9f86d15af08e33a87c2b84610788615",
"block_number": 389520,
"created_at": "2026-05-26T03:14:56Z",
"updated_at": "2026-06-04T13:18:56Z",
"completed_at": "2026-06-10T08:20:06Z"
},
{
"id": 7066,
"currency": "dot",
"amount": "7.1227",
"fee": "0.2371",
"address": "https://polkascan.io/polkadot/account/1DHydtVZhFyD349P26ii1Bwasb48u8R5oT",
"memo": "",
"status": "failed",
"chain": "dot",
"txid": "84d5a88fd90fd1ce8f07defacfe97f6cb9f86d15af08e33a87c2b84610788615",
"block_number": null,
"created_at": "2026-05-25T20:00:40Z",
"updated_at": "2026-06-04T12:41:02Z",
"completed_at": null
},
{
"id": 5495,
"currency": "dot",
"amount": "7.1227",
"fee": "0.1761",
"address": "https://polkascan.io/polkadot/account/1DHydtVZhFyD349P26ii1Bwasb48u8R5oT",
"memo": "",
"status": "succeed",
"chain": "dot",
"txid": "84d5a88fd90fd1ce8f07defacfe97f6cb9f86d15af08e33a87c2b84610788615",
"block_number": 253879,
"created_at": "2026-05-25T01:06:34Z",
"updated_at": "2026-06-04T08:27:26Z",
"completed_at": "2026-06-10T07:30:22Z"
},
{
"id": 4119,
"currency": "dot",
"amount": "7.1227",
"fee": "0.0075",
"address": "https://polkascan.io/polkadot/account/1DHydtVZhFyD349P26ii1Bwasb48u8R5oT",
"memo": "",
"status": "queued",
"chain": "dot",
"txid": "84d5a88fd90fd1ce8f07defacfe97f6cb9f86d15af08e33a87c2b84610788615",
"block_number": null,
"created_at": "2026-05-23T15:59:25Z",
"updated_at": "2026-06-02T13:59:19Z",
"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'
Запрос возвращает IP-адрес строкой:
"12.141.166.167"
Получить ваш 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-06-10T13:30:53+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": "shibomr",
"name": "SHIB/OMR",
"ask_unit": "shib",
"bid_unit": "omr",
"min_ask": 0.89403,
"min_bid": 0.67736,
"maker_fee": 0.5048,
"taker_fee": 0.759
},
{
"symbol": "filpln",
"name": "FIL/PLN",
"ask_unit": "fil",
"bid_unit": "pln",
"min_ask": 0.56314,
"min_bid": 0.59276,
"maker_fee": 0.3994,
"taker_fee": 0.967
},
{
"symbol": "adaqar",
"name": "ADA/QAR",
"ask_unit": "ada",
"bid_unit": "qar",
"min_ask": 0.16784,
"min_bid": 0.07435,
"maker_fee": 0.4882,
"taker_fee": 0.742
}
]
Получить список торговых пар на спотовом рынке
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-коды
Структура ответа с ошибкой от API приведена на примере:
{
"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=ethaed&stream=trading_ui_order_book&stream=ext_markets
Подписка на поток свечных данных (K-line)
WebSocket endpoint для получения данных свечей (K-line) с указанным интервалом для торговой пары.
/?stream=btcxcd-kline-1h');
ws.onmessage = (event) => { console.log(JSON.parse(event.data)); }; ``` %>
WebSocket URL
wss://ws.tokenspot.com/?stream={pair}-kline-{interval}
Параметры подключения
| Параметр | Описание | Обязательный | Пример значения |
|---|---|---|---|
| pair | Идентификатор торговой пары | Да | btcxcd |
| 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 | Объем торгов за интервал |
Пример сообщения:
{
"btcxcd-kline-1h": {
"close": 50.0,
"high": 100.0,
"low": 44.19,
"open": 100.0,
"time": 1781098253,
"volume": 3.92
}
}
Доступные интервалы
| Интервал | Описание |
|---|---|
| 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 минут и т.д.
Примеры подключения:
Минутные данные для пары BTC/USDT:
const ws = new WebSocket('wss://ws.tokenspot.com/?stream=btcusdt-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
{
"trxern.orderbook": {
"ask": [
{
"id": 1876,
"price": "85.0",
"volume": "1130.2682",
"amount": "96072.79699999999",
"factor": "0.4339",
"rate_source": "",
"rate_source_s": "",
"type": "limit"
}
],
"bid": [
{
"id": 8510,
"price": "95.2",
"volume": "9812.3823",
"amount": "934138.79496",
"factor": "-0.0086",
"rate_source": "",
"rate_source_s": "",
"type": "limit"
},
{
"id": 7313,
"price": "80.0",
"volume": "4055.8524",
"amount": "324468.19200000004",
"factor": "-0.1998",
"rate_source": "",
"rate_source_s": "",
"type": "market"
},
{
"id": 4724,
"price": "92.4",
"volume": "9877.6186",
"amount": "912691.9586400001",
"factor": "-0.5636",
"rate_source": "",
"rate_source_s": "",
"type": "limit"
},
{
"id": 3607,
"price": "80.0",
"volume": "9793.0509",
"amount": "783444.072",
"factor": "-0.0796",
"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
{
"neofjd.ticker": {
"low": "61.07",
"high": "20.0",
"last": "35.04",
"rlast": "31.84",
"at": 1781098253,
"open": "97.82",
"base_volume": "694.6",
"quote_volume": "3896.7",
"sell": "98.78",
"buy": "97.17",
"price_change_percent": "3.9021719156",
"market_cap": 39653156834275.3
}
}
Структура данных
| Поле | Тип | Описание |
|---|---|---|
| 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": "maticpkr",
"type": "sell",
"date": 1781001661,
"amount": "5337.65",
"price": "75.76",
"volume": "9646.2874",
"ask": "matic",
"bid": "pkr"
}
]
}
}
Структура данных
| Поле | Тип | Описание |
|---|---|---|
| tid | integer | идентификатор сделки |
| market | string | название рынка |
| type | string | тип сделки (покупка/продажа) |
| date | integer | Дата |
| amount | float | Стоимость сделки |
| price | float | Цена единицы (ask/bid) |
| volume | float | Объем сделки |
| ask | string | Валюта |
| bid | string | Валюта |