GET
/
orders
/
{order_id}
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

200
application/json

The response is of type object.