NAV
bash ruby javascript

Введение

Документация описывает работу с Tokenspot REST API.

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

Авторизация

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

DATA = TIMESTAMP + KEY_UID + RECV_WINDOW + PAYLOAD

SIGN = HMAC-SHA256(DATA, API_KEY_SECRET)

Aлгоритм HMAC

Где:

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

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

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

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

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

Пример прохождения авторизации:

  def build_signature(secret_sg_key, headers:, url:, body:, request_method:)
    payload = case request_method
              when 'GET'
                URI(url).query || ''
              when 'POST'
                body || ''
              else
                ""
              end
    line = headers["TS-API-TIMESTAMP"] + headers["TS-API-API-KEY"] + (headers['TS-API-RECV-WINDOW'] || "") + payload
    OpenSSL::HMAC.hexdigest('sha256', secret_sg_key, line)
  end

// <script src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js" integrity="sha512-E8QSvWZ0eCLGk4km3hxSsNmGWbLtSCSUcewDQPQWZF6pEU8GlT8a5fF32wOl1i8ftdMhssTrF/OhyGWwonTcXA==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
  let payload = ""
  if(reqType == 'post') {
    payload += body
  } else {
    payload += query
  }

  const line = timestamp + uid + rwindow + payload;
  const val = CryptoJS.HmacSHA256(line, secret).toString(CryptoJS.enc.Hex)

Аккаунт

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

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

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/account/api_key?uid=<KEY_UID>'

Пример ответа:

{
  "uid": "111111-1111-11111-11111-11111",
  "name": "test-api-key",
  "network_mask": "0.0.0.0/0,::/0",
  "trading_permitted": true,
  "withdrawals_permitted": true,
  "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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/account/info'

Пример ответа:

{
  "uid": "ID123BF9038F9123",
  "email": "[email protected]",
  "nickname": null,
  "balances": [
    {
      "currency": "btc",
      "balance": "9998.9999",
      "locked": "1.0001",
      "order_locked": "0.0",
      "withdraw_locked": "1.0001",
      "p2p_locked": "0.0",
      "credit_limit": "10000.0",
      "available_to_withdraw": "19998.9999"
      "credit_usage_fee": "0.001",
      "credit_overdue_fee": "0.002"
    },
    {
      "currency": "usd",
      "balance": "10000.0",
      "locked": "0.0",
      "order_locked": "0.0",
      "withdraw_locked": "0.0",
      "p2p_locked": "0.0",
      "credit_limit": "10000.0",
      "available_to_withdraw": "20000.0"
      "credit_usage_fee": "0.001",
      "credit_overdue_fee": "0.002"
    },
    ...
    {
      "currency": "usdt",
      "balance": "10000.0",
      "locked": "0.0",
      "order_locked": "0.0",
      "withdraw_locked": "0.0",
      "p2p_locked": "0.0",
      "credit_limit": "10000.0",
      "available_to_withdraw": "20000.0"
      "credit_usage_fee": "0.001",
      "credit_overdue_fee": "0.002"
    }
  ],
  "trading_permitted": true,
  "withdrawals_permitted": true,
  "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=usd&direction=deposit'

Пример ответа:

[
  {
    "id": 1,
    "direction": "deposit",
    "currency": "usd",
    "title": "Офис Бишкек",
    "description": "...",
    "instructions": "...",
    "min_amount": "1000.0",
    "max_amount": "1000000.0",
    "rounding": "100.0",
    "fee": "0.0",
    "fee_fixed": "0.0",
    "fee_limit": "0.0"
  },
  {
    "id": 2,
    "direction": "deposit",
    "currency": "usd",
    "title": "Банковский перевод",
    "description": "...",
    "instructions": "...",
    "min_amount": "1000.0",
    "max_amount": "1000000.0",
    "rounding": "0.01",
    "fee": "0.01",
    "fee_fixed": "0.0",
    "fee_limit": "0.0"
  }
]

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": "btc",
    "symbol": "฿",
    "chains": [
      {
        "withdraw_fee": "0.0001",
        "title": "btc",
        "deposit_status": "allowed",
        "deposit_status_description": "",
        "withdraw_status": "allowed",
        "withdraw_status_description": "",
        "blockchain": "btc",
        "min_deposit_amount": "0.0002",
        "min_withdraw_amount": "0.001"
      },
      ...
    ],
    "type": "coin",
    "precision": 8
  },
  ...
]

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": "btc",
    "explorer_transaction": "https://www.blockchain.com/btc/tx/#{txid}",
    "explorer_address": "https://www.blockchain.com/btc/address/#{address}",
    "min_confirmations": 1,
    "hold_timeout_minutes": 30
  },
  ...
  {
    "key": "ethereum",
    "explorer_transaction": "https://etherscan.io/tx/#{txid}",
    "explorer_address": "https://etherscan.io/address/#{address}",
    "min_confirmations": 6,
    "hold_timeout_minutes": 30
  }
]

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=btc'

Пример ответа:

{
  "id": "btc",
  "symbol": "฿",
  "chains": [
    {
      "withdraw_fee": "0.0001",
      "title": "btc",
      "deposit_status": "allowed",
      "deposit_status_description": "",
      "withdraw_status": "allowed",
      "withdraw_status_description": "",
      "blockchain": "btc",
      "min_deposit_amount": "0.0002",
      "min_withdraw_amount": "0.001"
    },
    ...
  ],
  "type": "coin",
  "precision": 8
},

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/asset/balance_list'

Пример ответа:

[
  {
    "currency": "btc",
    "balance": "9998.9999",
    "locked": "1.0001",
    "order_locked": "0.0",
    "withdraw_locked": "1.0001",
    "p2p_locked": "0.0",
    "credit_limit": "10000.0",
    "available_to_withdraw": "19998.9999"
    "credit_usage_fee": "0.001",
    "credit_overdue_fee": "0.002"
  },
  ...
  {
    "currency": "usdt",
    "balance": "10000.0",
    "locked": "0.0",
    "order_locked": "0.0",
    "withdraw_locked": "0.0",
    "p2p_locked": "0.0",
    "credit_limit": "10000.0",
    "available_to_withdraw": "20000.0"
    "credit_usage_fee": "0.001",
    "credit_overdue_fee": "0.002"
  }
]

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/asset/balance?currency=btc'

Пример ответа:

{
  "currency": "btc",
  "balance": "9998.9999",
  "locked": "1.0001",
  "order_locked": "0.0",
  "withdraw_locked": "1.0001",
  "p2p_locked": "0.0",
  "credit_limit": "10000.0",
  "available_to_withdraw": "19998.9999"
  "credit_usage_fee": "0.001",
  "credit_overdue_fee": "0.002"
}

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 Выполнена частично

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

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

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

Пример ответа:

[
  {
    "id": 1,
    "price": "6508447.83",
    "amount": "0.00015211",
    "total": "990.0",
    "symbol": null,
    "created_at": "2024-07-19T14:21:14Z"
  },
  ...
  {
    "id": 2,
    "price": "6508397.93",
    "amount": "0.00001548",
    "total": "100.75",
    "symbol": null,
    "created_at": "2024-06-30T02:30:19Z"
  }
]

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/depth?symbol=btcrub'

Пример ответа:

{
  "timestamp": 1723552710,
  "asks": [
    {
      "price": "6508346.0",
      "volume": "0.65882757",
      "amount": "4287877.78"
    },
    ...
    {
      "price": "6.0",
      "volume": "12.01166667",
      "amount": "72.07"
    }
  ],
  "bids": [
    {
      "price": "6508346.0",
      "volume": "0.65882757",
      "amount": "4287877.78"
    },
    ...
    {
      "price": "6.0",
      "volume": "12.01166667",
      "amount": "72.07"
    }
  ]
}

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?symbol=btcrub&trade_id=1&period=1&limit=30'

Пример ответа:

{
  "k": [
    {
      "close": 6508447.83,
      "high": 6508447.83,
      "low": 6508447.83,
      "open": 6508447.83,
      "time": 1723551360,
      "volume": 0
    },
    ...
    {
      "close": 6508447.83,
      "high": 6508447.83,
      "low": 6508447.83,
      "open": 6508447.83,
      "time": 1723553100,
      "volume": 0
    }
  ],
  "trades": []
}

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?symbol=btcrub&period=1&limit=30'

Пример ответа:

[
  {
    "close": 6508447.83,
    "high": 6508447.83,
    "low": 6508447.83,
    "open": 6508447.83,
    "time": 1723551360,
    "volume": 0
  },
  ...
  {
    "close": 6508447.83,
    "high": 6508447.83,
    "low": 6508447.83,
    "open": 6508447.83,
    "time": 1723553100,
    "volume": 0
  }
]

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
       'https://api.tokenspot.com/api/v1/spot/my_trades?order_by=DESC'

Пример ответа:

[
  {
    "id": "1",
    "order_id": 1,
    "symbol": "btcusdt",
    "is_maker": false,
    "price": "63019.0",
    "amount": "0.01",
    "total": "630.19",
    "fee": "0.005",
    "fee_size": "3.15",
    "created_at": "2024-07-15T14:50:25Z",
    "side": "sell"
  },
  {
    "id": "2",
    "order_id": 2,
    "symbol": "btcusdt",
    "is_maker": false,
    "price": "62486.25",
    "amount": "1.0",
    "total": "62486.25",
    "fee": "0.005",
    "fee_size": "312.43",
    "created_at": "2024-07-15T13:34:47Z",
    "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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'side=sell&volume=1&type=limit&volume_unit=base&price=100&client_order_id=1231234&symbol=btcrub' \
     'https://api.tokenspot.com/api/v1/spot/order'

Пример ответа:

{
  "id": "111",
  "client_order_id": "1231234",
  "symbol": "btcrub",
  "remaining_volume": "1.0",
  "executed_volume": "0.0",
  "volume": "1.0",
  "side": "ask",
  "type": "limit",
  "status": "new",
  "price": "0.0",
  "funds_received": "0.0",
  "funds_fee": "0.0",
  "trades_count": 0,
  "avg_price": 0,
  "executed_amount": "0.0",
  "quote_amount": "0.0",
  "created_at": "2024-08-13T13:31:27Z",
  "updated_at": "2024-08-13T13:31:27Z"
}

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      'https://api.tokenspot.com/api/v1/spot/order_info?id=111'

Пример ответа:

{
  "id": "111",
  "client_order_id": "1231234",
  "symbol": "btcrub",
  "remaining_volume": "1.0",
  "executed_volume": "0.0",
  "volume": "1.0",
  "side": "ask",
  "type": "market",
  "status": "canceled",
  "price": "0.0",
  "funds_received": "0.0",
  "funds_fee": "0.0",
  "trades_count": 0,
  "avg_price": 0,
  "executed_amount": "0.0",
  "quote_amount": "0.0",
  "created_at": "2024-08-13T13:31:27Z",
  "updated_at": "2024-08-13T13:31:27Z"
}

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'id=111' \
     'https://api.tokenspot.com/api/v1/spot/cancel_order'

Пример ответа:

{
  "id": "111",
  "client_order_id": "1231234",
  "symbol": "btcrub",
  "remaining_volume": "1.0",
  "executed_volume": "0.0",
  "volume": "1.0",
  "side": "ask",
  "type": "market",
  "status": "canceled",
  "price": "0.0",
  "funds_received": "0.0",
  "funds_fee": "0.0",
  "trades_count": 0,
  "avg_price": 0,
  "executed_amount": "0.0",
  "quote_amount": "0.0",
  "created_at": "2024-08-13T13:31:27Z",
  "updated_at": "2024-08-13T13:31:27Z"
}

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": "111",
    "client_order_id": "1231234",
    "symbol": "btcrub",
    "remaining_volume": "1.0",
    "executed_volume": "0.0",
    "volume": "1.0",
    "side": "ask",
    "type": "market",
    "status": "canceled",
    "price": "0.0",
    "funds_received": "0.0",
    "funds_fee": "0.0",
    "trades_count": 0,
    "avg_price": 0,
    "executed_amount": "0.0",
    "quote_amount": "0.0",
    "created_at": "2024-08-13T13:31:27Z",
    "updated_at": "2024-08-13T13:31:27Z"
  }
]

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/spot/order_history?symbol=btcrub'

Пример ответа:

[
  {
    "id": "111",
    "client_order_id": "1231234",
    "symbol": "btcrub",
    "remaining_volume": "1.0",
    "executed_volume": "0.0",
    "volume": "1.0",
    "side": "ask",
    "type": "market",
    "status": "canceled",
    "price": "0.0",
    "funds_received": "0.0",
    "funds_fee": "0.0",
    "trades_count": 0,
    "avg_price": 0,
    "executed_amount": "0.0",
    "quote_amount": "0.0",
    "created_at": "2024-08-13T13:31:27Z",
    "updated_at": "2024-08-13T13:31:27Z"
  }
]

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": "kgs",
    "withdraw_fee": "0.0",
    "deposit_fee": "0.0"
  },
  {
    "currency": "usd",
    "withdraw_fee": "0.0",
    "deposit_fee": "0.0"
  }
]

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 'currency=usd&amount=1&client_id=test' \
     'https://api.tokenspot.com/api/v1/code/create'

Пример ответа:

{
  "id": "CD3111EBB470385",
  "code": "MXUKMKTR111HI2U1JMAP",
  "client_id": "test",
  "currency": "usd",
  "amount": "1.0",
  "used": false,
  "fee": "0.0",
  "created_at": "2024-08-12T13:23:21.475Z",
  "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": "CD38AEBB470385",
  "code": "123123123",
  "client_id": "test",
  "currency": "usd",
  "amount": "1.0",
  "used": true,
  "fee": "0.0",
  "created_at": "2024-08-12T13:23:21.475Z",
  "used_at": "2024-08-12T13:28:09.800Z"
}

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": "1231****",
  "client_id": "test",
  "currency": "usd",
  "amount": "1.0",
  "used": true,
  "fee": "0.0",
  "created_at": "2024-08-12T13:23:21.475Z",
  "used_at": "2024-08-12T13:28:09.800Z"
}

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": "FZLTD***************",
  "client_id": "test123",
  "currency": "rub",
  "amount": "10.0",
  "used": false,
  "created_at": "2024-07-26T16:38:42.179Z",
  "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": "B22638111199AF",
    "code": "FZLTD***************",
    "client_id": "test123",
    "currency": "rub",
    "amount": "10.0",
    "used": false,
    "created_at": "2024-07-26T16:38:42.179Z",
    "used_at": null
  },
  ...
  {
    "id": "28702222898",
    "code": "QYMLQ***************",
    "client_id": null,
    "currency": "rub",
    "amount": "100.0",
    "used": true,
    "created_at": "2024-07-23T11:25:35.295Z",
    "used_at": "2024-07-23T11:32:26.616Z"
  }
]

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 'currency=btc&chain=btc' \
     'https://api.tokenspot.com/api/v1/deposit_address/create'

Пример ответа:

{
  "id": 1111,
  "address": null,
  "blockchain": "btc",
  "created_at": "2024-08-12T16:20:28.647Z",
  "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/indo?id=123123'

Пример ответа:

{
  "id": 123123,
  "address": null,
  "blockchain": "btc",
  "created_at": "2024-08-12T16:20:28.647Z",
  "currency": "btc"
}

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=btc&currency=btc'

Пример ответа:

[
  {
    "id": 123123,
    "address": null,
    "blockchain": "btc",
    "created_at": "2024-08-12T16:20:28.647Z",
    "currency": "btc"
  }
]

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=btc&currency=btc'

Пример ответа:

{
  "id": 123123,
  "address": null,
  "blockchain": "btc",
  "created_at": "2024-08-12T16:20:28.647Z",
  "currency": "btc"
}

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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'currency=usd&status=submitted' \
     'https://api.tokenspot.com/api/v1/deposit/history'

Пример ответа:

[
  {
        "id": "123123",
        "currency": "btc",
        "type": "coin",
        "amount": "0.001",
        "fee": "0.0",
        "txid": "123123",
        "block_number": null,
        "confirmations": null,
        "status": "submitted",
        "chain": "btc-testnet",
        "address": "...",
        "created_at": "2023-07-17T16:23:41+03:00",
        "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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
     'https://api.tokenspot.com/api/v1/deposit/info?txid=12332'

Пример ответа:

{
      "id": "123123",
      "currency": "btc",
      "type": "coin",
      "amount": "0.001",
      "fee": "0.0",
      "txid": "12332",
      "block_number": null,
      "confirmations": null,
      "status": "submitted",
      "chain": "btc-testnet",
      "address": "...",
      "created_at": "2023-07-17T16:23:41+03:00",
      "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: 1723464672584' \
      --header 'TS-API-RECV-WINDOW: 100000' \
      --header 'TS-API-SIGN: <SIGN>' \
      -d 'currency=usd&amount=1&client_id=test' \
     'https://api.tokenspot.com/api/v1/withdraw/coin/create'

Пример ответа:

{
  "id": "111",
  "currency": "btc",
  "amount": "1.0001",
  "fee": "0.0001",
  "address": "123",
  "memo": "",
  "status": "submitted",
  "chain": "btc",
  "txid": null,
  "block_number": null,
  "created_at": "2024-08-13T21:50:04Z",
  "updated_at": "2024-08-13T21:50:04Z",
  "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": "btc",
    "min_amount": "0.001",
    "fee": [
      {
        "type": "fixed",
        "value": "0.0001"
      }
    ]
  },
  ...
  {
    "currency": "dai",
    "min_amount": "30.0",
    "fee": [
      {
        "type": "fixed",
        "value": "15.0"
      }
    ]
  }
]

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=111'

Пример ответа:

{
  "id": "111",
  "currency": "btc",
  "amount": "1.0001",
  "fee": "0.0001",
  "address": "123",
  "memo": "",
  "status": "submitted",
  "chain": "btc",
  "txid": null,
  "block_number": null,
  "created_at": "2024-08-13T21:50:04Z",
  "updated_at": "2024-08-13T21:50:04Z",
  "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>' \
      -d 'currency=usd&amount=1&client_id=test' \
     'https://api.tokenspot.com/api/v1/withdraw/history'

Пример ответа:

[
  {
  "id": "111",
  "currency": "btc",
  "amount": "1.0001",
  "fee": "0.0001",
  "address": "123",
  "memo": "",
  "status": "submitted",
  "chain": "btc",
  "txid": null,
  "block_number": null,
  "created_at": "2024-08-13T21:50:04Z",
  "updated_at": "2024-08-13T21:50:04Z",
  "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-адрес строкой:

"11.111.111.111"

Получить ваш 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'

Запрос возвращает время на сервере:

"2024-08-09T13:40:38+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": "btcrub",
    "name": "BTC/RUB",
    "ask_unit": "btc",
    "bid_unit": "rub",
    "min_ask": "0.00001",
    "min_bid": "5.0",
    "maker_fee": "0.0025",
    "taker_fee": "0.005"
  },
  {
    "symbol": "ethusdt",
    "name": "ETH/USDT",
    "ask_unit": "eth",
    "bid_unit": "usdt",
    "min_ask": "0.00025",
    "min_bid": "0.1",
    "maker_fee": "0.0025",
    "taker_fee": "0.005"
  },
  {
    "symbol": "usdtusd",
    "name": "USDT/USD",
    "ask_unit": "usdt",
    "bid_unit": "usd",
    "min_ask": "0.1",
    "min_bid": "0.0",
    "maker_fee": "0.0025",
    "taker_fee": "0.005"
  }
]

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

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.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 Неверные аргументы для лимитного ордера
bash ruby javascript