Skip to main content
GET
/
orders
/
{order_id}
Get single order
curl --request GET \
  --url https://api.exchange.coinbase.com/orders/{order_id} \
  --header 'cb-access-key: <api-key>' \
  --header 'cb-access-passphrase: <api-key>' \
  --header 'cb-access-sign: <api-key>' \
  --header 'cb-access-timestamp: <api-key>'
{
  "id": "a9625b04-fc66-4999-a876-543c3684d702",
  "price": "10.00000000",
  "size": "1.00000000",
  "product_id": "BTC-USD",
  "profile_id": "8058d771-2d88-4f0f-ab6e-299c153d4308",
  "side": "buy",
  "type": "limit",
  "time_in_force": "GTC",
  "post_only": true,
  "max_floor": "4",
  "created_at": "2020-03-11T20:48:46.622Z",
  "fill_fees": "0.0000000000000000",
  "filled_size": "0.00000000",
  "executed_value": "0.0000000000000000",
  "status": "open",
  "settled": false
}

​
API Key Permissions

This endpoint requires either the “view” or “trade” permission. Orders can be queried using either the exchange assigned id or the client assigned client_oid. When using client_oid it must be preceded by the client: namespace. If the order is canceled, and if the order had no matches, the response might return the status code 404.
Open orders can change state between the request and the response depending on market conditions.

Authorizations

​
cb-access-key
string
header
required
​
cb-access-passphrase
string
header
required
​
cb-access-sign
string
header
required
​
cb-access-timestamp
string
header
required

Path Parameters

​
order_id
string
required

order_id is either the exchange assigned id or the client assigned client_oid. When using client_oid it must be preceded by the client: namespace.

Query Parameters

​
market_type
string
default:spot

Market type which the order was traded in.

Response

​
id
string
required

uuid

​
product_id
string
required

book the order was placed on

​
side
enum<string>
default:buy
required
Available options:
buy,
sell
​
type
enum<string>
default:limit
required
Available options:
limit,
market,
stop
​
post_only
boolean
required

if true, forces order to be maker only

​
created_at
string<date-time>
required

timestamp at which order was placed

​
fill_fees
string
required

fees paid on current filled amount

​
filled_size
string
required

amount (in base currency) of the order that has been filled

​
status
enum<string>
default:open
required
Available options:
open,
pending,
rejected,
done,
active,
received,
all
​
settled
boolean
required

true if funds have been exchanged and settled

​
price
string

price per unit of base currency

​
size
string

amount of base currency to buy/sell

​
profile_id
string

profile_id that placed the order

​
funds
string

amount of quote currency to spend (for market orders)

​
specified_funds
string

funds with fees

​
time_in_force
enum<string>
default:GTC
Available options:
GTC,
GTT,
IOC,
FOK
​
expire_time
string<date-time>

timestamp at which order expires

​
done_at
string<date-time>

timestamp at which order was done

​
done_reason
string

reason order was done (filled, rejected, or otherwise)

​
reject_reason
string

reason order was rejected by engine

​
executed_value
string
​
stop
enum<string>
default:loss
Available options:
loss,
entry
​
stop_price
string

price (in quote currency) at which to execute the order

​
funding_amount
string
​
client_oid
string

client order id

​
market_type
string

market type where order was traded

​
max_floor
string

maximum visible quantity for iceberg order

​
secondary_order_id
string

order id for the visible order for iceberg order

​
stop_limit_price
string

stop limit price for TPSL order