API 文档

TokenEx 提供 RESTful API 和 WebSocket 实时数据流,支持行情查询、下单撮合、订单管理等完整功能。

认证方式

所有需要认证的接口请在请求头中携带 Bearer Token:

Authorization: Bearer YOUR_API_KEY
频率限制
100
请求/秒(公开接口)
50
请求/秒(交易接口)
5
WebSocket 连接数

接口列表

GET
/api/v1/markets
获取所有交易对行情
{
  "data": [
    {
      "token_id": "gpu-a100",
      "name": "A100 推理",
      "price": 0.003200,
      "change_24h": 5.2,
      "volume_24h": 1280000
    }
  ]
}
GET
/api/v1/orderbook/:token_id
获取指定交易对的订单簿
{
  "bids": [
    { "price": 0.003180, "quantity": 12000 }
  ],
  "asks": [
    { "price": 0.003220, "quantity": 8500 }
  ]
}
POST
/api/v1/orders
提交新订单(需认证)
{
  "id": "order_abc123",
  "status": "open",
  "side": "buy",
  "price": 0.003200,
  "quantity": 10000
}
DELETE
/api/v1/orders/:id
撤销指定订单(需认证)
{
  "id": "order_abc123",
  "status": "cancelled"
}
GET
/api/v1/trades/:token_id
获取最近成交记录
{
  "data": [
    {
      "price": 0.003210,
      "quantity": 5000,
      "side": "buy",
      "timestamp": "2026-04-07T10:30:00Z"
    }
  ]
}
WS
wss://api.tknex.net/v1/stream
WebSocket 实时数据流(行情、订单簿、成交)
{
  "channel": "trades:gpu-a100",
  "event": "new_trade",
  "data": {
    "price": 0.003215,
    "quantity": 3000
  }
}