Retrieve order
GET/v1/orders/:id
Retrieves the order for the given id.
Request
Path Parameters
Responses
- 200
- 401
- 403
- 404
- 409
- 500
Your request has been successfully processed.
- application/json
- Schema
- Example (from schema)
Schema
Unique identifier for the order
Order type may be either limit order or market order.
Possible values: [limit, market]
limitCurrent fulfillment state of the order
Client's unique identifier for the order.
The currency that you want to buy.
The currency that you want to sell.
The amount that you want to buy.
The amount that you want to sell.
The tenor value for the quote e.g. SPOT, CASH (T+0), NEXT DAY (T+1)
Possible values: [SPOT, TOD, TOM]
SPOTSPOTRestrict quotes to specified sources.
limit price for the order using market conventions. Valid for limit orders only.
Order notes.
Possible values: <= 256 characters
status
object
Order status for the specified order id.
Order status for given order id.
Possible values: [pending, filled, killed]
Timestamp of last status update.
{
"id": "string",
"order_type": "limit",
"order_state": "string",
"client_order_id": "string",
"buy_currency": "string",
"sell_currency": "string",
"buy_amount": 0,
"sell_amount": 0,
"tenor": "SPOT",
"sources": [
"string"
],
"limit_price": 0,
"order_notes": "string",
"status": {
"status": "pending",
"timestamp": "2024-07-29T15:51:28.071Z"
}
}
Authentication token is required for this action that was not provided, expired or invalid.
- application/json
- Schema
- Example (from schema)
Schema
Links error message to a specific event in the system.
The code for the error that has occurred.
The text for the error that has occurred.
An optional parameter name related to the error. Usually present for input validation errors.
An optional parameter value related to the error. Set to input value of named parameter.
{
"errorId": "string",
"code": "string",
"text": "string",
"parameter_name": "string",
"parameter_value": {}
}
Not authorized for the requested action.
- application/json
- Schema
- Example (from schema)
Schema
Links error message to a specific event in the system.
The code for the error that has occurred.
The text for the error that has occurred.
An optional parameter name related to the error. Usually present for input validation errors.
An optional parameter value related to the error. Set to input value of named parameter.
{
"errorId": "string",
"code": "string",
"text": "string",
"parameter_name": "string",
"parameter_value": {}
}
The requested endpoint or entity does not exist.
- application/json
- Schema
- Example (from schema)
Schema
Links error message to a specific event in the system.
The code for the error that has occurred.
The text for the error that has occurred.
An optional parameter name related to the error. Usually present for input validation errors.
An optional parameter value related to the error. Set to input value of named parameter.
{
"errorId": "string",
"code": "string",
"text": "string",
"parameter_name": "string",
"parameter_value": {}
}
Action could not be completed because of conflict.
- application/json
- Schema
- Example (from schema)
Schema
Links error message to a specific event in the system.
The code for the error that has occurred.
The text for the error that has occurred.
An optional parameter name related to the error. Usually present for input validation errors.
An optional parameter value related to the error. Set to input value of named parameter.
{
"errorId": "string",
"code": "string",
"text": "string",
"parameter_name": "string",
"parameter_value": {}
}
Internal server error.
- application/json
- Schema
- Example (from schema)
Schema
Links error message to a specific event in the system.
The code for the error that has occurred.
The text for the error that has occurred.
An optional parameter name related to the error. Usually present for input validation errors.
An optional parameter value related to the error. Set to input value of named parameter.
{
"errorId": "string",
"code": "string",
"text": "string",
"parameter_name": "string",
"parameter_value": {}
}