Trades

View and manage trades.

Endpoints

Method	Path	Description
GET	/v1/trades	List trades
GET	/v1/trades/:id	Get trade
GET	/v1/trades/analytics	Get trade analytics
POST	/v1/trades	Create trade
POST	/v1/trades/:id/cancel	Cancel trade

---

List Trades

GET /v1/trades

Query Parameters:

Parameter	Type	Description
strategy_id	string	Filter by strategy
exchange_account_id	string	Filter by exchange account
status	string	PENDING, FILLED, PARTIALLY_FILLED, CANCELLED, FAILED
side	string	BUY or SELL
limit	integer	Max results (default 50, max 100)
offset	integer	Pagination offset

curl "https://api.tokenbot.com/v1/trades?status=FILLED&limit=10" \
  -H "X-API-Key: tb_live_your_key"

---

Get Trade

GET /v1/trades/:id

---

Get Trade Analytics

GET /v1/trades/analytics

Returns aggregated trade performance metrics.

curl https://api.tokenbot.com/v1/trades/analytics \
  -H "X-API-Key: tb_live_your_key"

---

Create Trade

POST /v1/trades

Request Body:

{
  "exchange_account_id": "exc_abc123",
  "trade_pair_id": "tp_btcusdt",
  "type": "LIMIT",
  "side": "BUY",
  "price": 50000.00,
  "amount": 0.1
}

---

Cancel Trade

POST /v1/trades/:id/cancel

curl -X POST https://api.tokenbot.com/v1/trades/trd_abc123/cancel \
  -H "X-API-Key: tb_live_your_key"