Get an order by client ID

curl --request GET \
  --url https://tradingapi.dev/v1/orders/by-client-id/{client_order_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://tradingapi.dev/v1/orders/by-client-id/{client_order_id}"

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/by-client-id/{client_order_id}', 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/by-client-id/{client_order_id}"

	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))

}

{
  "object": "order",
  "id": "<string>",
  "client_order_id": "<string>",
  "market": "<string>",
  "side": "buy",
  "type": "market",
  "status": "pending",
  "status_reason": {
    "code": "no_liquidity_in_limit",
    "message": "<string>"
  },
  "requested_value": "<string>",
  "requested_percent": "<string>",
  "reduce_only": true,
  "size": "<string>",
  "price": "<string>",
  "price_limit": "<string>",
  "time_in_force": "ioc",
  "filled_size": "<string>",
  "average_fill_price": "<string>",
  "filled_value": "<string>",
  "fee": "<string>",
  "position_effect": "open",
  "summary": "<string>",
  "notes": [
    {
      "code": "size_rounded",
      "message": "<string>"
    }
  ],
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "timeline": [
    {
      "at": "2023-11-07T05:31:56Z",
      "event": "received",
      "message": "<string>"
    }
  ]
}

{
  "error": {
    "type": "authentication",
    "code": "invalid_api_key",
    "message": "This API key is not valid. It may have been revoked.",
    "param": null,
    "hint": "Send a current key as Authorization: Bearer tapi_…. Keys are created and revoked on the account page.",
    "details": {},
    "errors": [],
    "retryable": false,
    "doc_url": "https://docs.tradingapi.dev/api-reference/errors#invalid_api_key"
  }
}

{
  "error": {
    "type": "not_found",
    "code": "order_not_found",
    "message": "No order with client_order_id \"dca-btc-0927\" was recorded. Nothing was traded.",
    "param": "client_order_id",
    "hint": "Sending the same request again with this client_order_id is safe.",
    "details": {},
    "errors": [],
    "retryable": false,
    "doc_url": "https://docs.tradingapi.dev/api-reference/errors#order_not_found"
  }
}

{
  "error": {
    "type": "rate_limited",
    "code": "rate_limited",
    "message": "This key made too many requests; retry in 1 s.",
    "param": null,
    "hint": "Slow down: each key may make 10 requests at once, then 5 a second.",
    "details": {},
    "errors": [],
    "retryable": true,
    "retry_after": "2026-09-28T14:05:12.000Z",
    "doc_url": "https://docs.tradingapi.dev/api-reference/errors#rate_limited"
  }
}

GET

orders

by-client-id

{client_order_id}

Get an order by client ID

curl --request GET \
  --url https://tradingapi.dev/v1/orders/by-client-id/{client_order_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://tradingapi.dev/v1/orders/by-client-id/{client_order_id}"

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/by-client-id/{client_order_id}', 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/by-client-id/{client_order_id}"

	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))

}

{
  "object": "order",
  "id": "<string>",
  "client_order_id": "<string>",
  "market": "<string>",
  "side": "buy",
  "type": "market",
  "status": "pending",
  "status_reason": {
    "code": "no_liquidity_in_limit",
    "message": "<string>"
  },
  "requested_value": "<string>",
  "requested_percent": "<string>",
  "reduce_only": true,
  "size": "<string>",
  "price": "<string>",
  "price_limit": "<string>",
  "time_in_force": "ioc",
  "filled_size": "<string>",
  "average_fill_price": "<string>",
  "filled_value": "<string>",
  "fee": "<string>",
  "position_effect": "open",
  "summary": "<string>",
  "notes": [
    {
      "code": "size_rounded",
      "message": "<string>"
    }
  ],
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "timeline": [
    {
      "at": "2023-11-07T05:31:56Z",
      "event": "received",
      "message": "<string>"
    }
  ]
}

{
  "error": {
    "type": "authentication",
    "code": "invalid_api_key",
    "message": "This API key is not valid. It may have been revoked.",
    "param": null,
    "hint": "Send a current key as Authorization: Bearer tapi_…. Keys are created and revoked on the account page.",
    "details": {},
    "errors": [],
    "retryable": false,
    "doc_url": "https://docs.tradingapi.dev/api-reference/errors#invalid_api_key"
  }
}

{
  "error": {
    "type": "not_found",
    "code": "order_not_found",
    "message": "No order with client_order_id \"dca-btc-0927\" was recorded. Nothing was traded.",
    "param": "client_order_id",
    "hint": "Sending the same request again with this client_order_id is safe.",
    "details": {},
    "errors": [],
    "retryable": false,
    "doc_url": "https://docs.tradingapi.dev/api-reference/errors#order_not_found"
  }
}

{
  "error": {
    "type": "rate_limited",
    "code": "rate_limited",
    "message": "This key made too many requests; retry in 1 s.",
    "param": null,
    "hint": "Slow down: each key may make 10 requests at once, then 5 a second.",
    "details": {},
    "errors": [],
    "retryable": true,
    "retry_after": "2026-09-28T14:05:12.000Z",
    "doc_url": "https://docs.tradingapi.dev/api-reference/errors#rate_limited"
  }
}

Authorizations

Authorization

string

header

required

An API key from the account page, sent as Authorization: Bearer tapi_….

Path Parameters

client_order_id

string

required

The client_order_id you sent when placing the order. Your ID for the order, 1 to 64 characters of letters, digits, ., _, : and -. Unique per account, forever.

Pattern: ^[A-Za-z0-9._:-]{1,64}$

Query Parameters

expand[]

enum<string>

Extra detail to include. timeline adds the order's history.

Available options:

timeline

Response

The order.

object

string

required

Allowed value: "order"

string

required

Our ID for the order.

client_order_id

string

required

Your ID for the order, 1 to 64 characters of letters, digits, ., _, : and -. Unique per account, forever.

Pattern: ^[A-Za-z0-9._:-]{1,64}$

market

string

required

side

enum<string>

required

Available options:

buy,

sell

type

enum<string>

required

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.

Available options:

market,

limit

status

enum<string>

required

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.

Available options:

pending,

filled,

canceled,

rejected

status_reason

object | null

required

Why an order is canceled or rejected. null otherwise.

Hide child attributes

status_reason.code

enum<string>

required

Available options:

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

status_reason.message

string

required

What happened, in a sentence, with the numbers involved.

requested_value

string | null

required

The value you sent. null for a close by percent or of the whole position.

requested_percent

string | null

required

The percent of a close. null otherwise.

reduce_only

boolean

required

size

string | null

required

The size sent to the market, in the market's units. null until the order is sized.

price

string | null

required

Your limit price as used. null for market orders.

price_limit

string | null

required

The worst price the order could fill at. For market orders, 0.5% from the price when it was placed.

time_in_force

enum<string>

required

Always ioc (immediate or cancel) for now.

Available options:

ioc

filled_size

string

required

A decimal number as a string, for example "250.00". Requests also accept a JSON number.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

average_fill_price

string | null

required

filled_value

string | null

required

The USD value that filled.

fee

string | null

required

Total fees paid, in USD, exact to 6 decimals. Can arrive shortly after the order finishes.

position_effect

enum<string> | null

required

What the order did to your position. null when nothing filled.

Available options:

open,

increase,

reduce,

close,

flip,

null

summary

string

required

What happened, in plain English. For people and language models; branch on fields, not on this text.

notes

object[]

required

Hide child attributes

notes.code

enum<string>

required

Available options:

size_rounded,

price_rounded,

position_flipped,

position_closed,

available_low,

partial_fill_likely,

trading_approval_expiring

notes.message

string

required

metadata

object

required

Up to 20 keys of your own, returned with the order and never interpreted. Keys up to 40 characters of letters, digits, _, . and -; string values up to 500 characters.

Hide child attributes

metadata.{key}

string

Maximum string length: 500

created_at

string<date-time>

required

RFC 3339 in UTC with milliseconds, for example 2026-09-27T14:30:00.123Z.

updated_at

string<date-time>

required

RFC 3339 in UTC with milliseconds, for example 2026-09-27T14:30:00.123Z.

completed_at

string<date-time> | null

required

When the order reached a final status.

timeline

object[]

Present only with expand[]=timeline.

Hide child attributes

timeline.at

string<date-time>

required

RFC 3339 in UTC with milliseconds, for example 2026-09-27T14:30:00.123Z.

timeline.event

enum<string>

required

Available options:

received,

admitted,

leverage_set,

sent,

filled,

partially_filled,

canceled,

rejected,

fees_recorded

timeline.message

string

required

Overview

Markets

Orders

Positions

Account

Get an order by client ID

Authorizations

Path Parameters

Query Parameters

Response