API REFERENCE

Orders & Trading

Trading – Orders & Positions

All trading calls require authentication and a linked user_id or external_user_id.

Place Order

POST /orders

1{
2  "user_id": "tl_user_9e8127",
3  "symbol": "BTCUSDT",
4  "side": "BUY",
5  "type": "LIMIT",
6  "size": "0.01",
7  "price": "92000.0",
8  "leverage": 50,
9  "time_in_force": "GTC",
10  "reduce_only": false,
11  "post_only": false,
12  "client_order_id": "my_platform_123"
13}

Response:

1{
2  "success": true,
3  "data": {
4    "order_id": "tl_ord_8192837",
5    "client_order_id": "my_platform_123",
6    "status": "NEW",
7    "filled_size": "0",
8    "symbol": "BTCUSDT",
9    "side": "BUY",
10    "type": "LIMIT",
11    "price": "92000.0",
12    "size": "0.01",
13    "leverage": 50,
14    "created_at": 1700483073300
15  }
16}

Get Open Orders

GET /orders/open?user_id=tl_user_9e8127&symbol=BTCUSDT

1{
2  "success": true,
3  "data": [
4    {
5      "order_id": "tl_ord_8192837",
6      "symbol": "BTCUSDT",
7      "side": "BUY",
8      "type": "LIMIT",
9      "price": "92000.0",
10      "size": "0.01",
11      "filled_size": "0.00",
12      "status": "NEW",
13      "leverage": 50,
14      "reduce_only": false,
15      "created_at": 1700483073300
16    }
17  ]
18}

Order History

GET /orders/history?user_id=tl_user_9e8127&symbol=BTCUSDT&page=1&page_size=50

Cancel Order

DELETE /orders/{order_id}

1{
2  "success": true,
3  "data": {
4    "order_id": "tl_ord_8192837",
5    "status": "CANCELED",
6    "canceled_at": 1700483080000
7  }
8}