curl --request GET \
--url https://tradingapi.dev/v1/orders \
--header 'Authorization: Bearer <token>'import requests
url = "https://tradingapi.dev/v1/orders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://tradingapi.dev/v1/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://tradingapi.dev/v1/orders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}List orders
Returns your orders, newest first, placed by any of your API keys.
curl --request GET \
--url https://tradingapi.dev/v1/orders \
--header 'Authorization: Bearer <token>'import requests
url = "https://tradingapi.dev/v1/orders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://tradingapi.dev/v1/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://tradingapi.dev/v1/orders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}Authorizations
An API key from the account page, sent as Authorization: Bearer tapi_….
Query Parameters
Only orders in this market.
Only orders with this status. Repeat the parameter to match several.
pending: recorded, and possibly sent; the outcome is not known yet.
filled: the whole size filled.
canceled: filled partly or not at all; the rest found no price within the limit.
rejected: refused; nothing filled.
More statuses will be added. Treat a status you don't recognise as not finished.
pending, filled, canceled, rejected How many items to return, from 1 to 100.
1 <= x <= 100The next_cursor from the previous page.
Extra detail to include. timeline adds the order's history.
timeline Response
A page of orders.
"list"Hide child attributes
Hide child attributes
"order"Our ID for the order.
Your ID for the order, 1 to 64 characters of letters, digits, ., _, : and -. Unique per account, forever.
^[A-Za-z0-9._:-]{1,64}$buy, sell market fills now at the best available prices, within 0.5% of the current price.
limit fills now at your price or better; whatever cannot fill at once is canceled.
market, limit pending: recorded, and possibly sent; the outcome is not known yet.
filled: the whole size filled.
canceled: filled partly or not at all; the rest found no price within the limit.
rejected: refused; nothing filled.
More statuses will be added. Treat a status you don't recognise as not finished.
pending, filled, canceled, rejected Why an order is canceled or rejected. null otherwise.
Hide child attributes
Hide child attributes
no_liquidity_in_limit, ioc_remainder, insufficient_balance, order_below_minimum, order_above_maximum, reduce_only_would_increase, no_position, market_unavailable, deadline_passed, refused_by_safeguards, not_sent, rejected_by_market, awaiting_market What happened, in a sentence, with the numbers involved.
The value you sent. null for a close by percent or of the whole position.
The percent of a close. null otherwise.
The size sent to the market, in the market's units. null until the order is sized.
Your limit price as used. null for market orders.
The worst price the order could fill at. For market orders, 0.5% from the price when it was placed.
Always ioc (immediate or cancel) for now.
ioc A decimal number as a string, for example "250.00". Requests also accept a JSON number.
^-?[0-9]+(\.[0-9]+)?$The USD value that filled.
Total fees paid, in USD, exact to 6 decimals. Can arrive shortly after the order finishes.
What the order did to your position. null when nothing filled.
open, increase, reduce, close, flip, null What happened, in plain English. For people and language models; branch on fields, not on this text.
RFC 3339 in UTC with milliseconds, for example 2026-09-27T14:30:00.123Z.
RFC 3339 in UTC with milliseconds, for example 2026-09-27T14:30:00.123Z.
When the order reached a final status.
Present only with expand[]=timeline.
Hide child attributes
Hide child attributes
RFC 3339 in UTC with milliseconds, for example 2026-09-27T14:30:00.123Z.
received, admitted, leverage_set, sent, filled, partially_filled, canceled, rejected, fees_recorded