Skip to main content
GET
/
trade
/
orders
/
by-external-id
/
{external_id}
Orders - User Order by External Id
curl --request GET \
  --url https://api.ripio.com/trade/orders/by-external-id/{external_id} \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>'
{
  "data": {
    "average_execution_price": 42600,
    "create_date": "2017-12-08T23:42:54.960Z",
    "external_id": "C90796F2-2CC3-4797-9AC3-A16BCC6936F0",
    "executed_amount": 0.02347418,
    "id": "8DE12108-4643-4E9F-8425-0172F1B96876",
    "remaining_amount": 0,
    "requested_amount": 0.02347418,
    "requested_value": 1000,
    "remaining_value": 0,
    "pair": "BTC_BRL",
    "price": 42600,
    "side": "buy",
    "status": "executed_completely",
    "fee": 0.002,
    "total_value": 1000,
    "type": "limit",
    "update_date": "2017-12-13T21:48:48.817Z",
    "transactions": [
      {
        "amount": 0.2,
        "create_date": "2020-02-21T20:24:43.433Z",
        "fee": 0.12,
        "fee_currency": "BTC",
        "price": 5000,
        "total_value": 1000
      },
      {
        "amount": 0.2,
        "create_date": "2020-02-21T20:49:37.450Z",
        "fee": 0.12,
        "fee_currency": "BTC",
        "price": 5000,
        "total_value": 1000
      }
    ]
  },
  "error_code": null,
  "message": null
}

Headers

​
authorization
string
required

The API key as a string.

​
signature
string
required

See the Generating Signature section for more details.

​
timestamp
number
required

A timestamp in milliseconds. See the Timestamp Security section for more details.

​
timstamp-tolerance
number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Path Parameters

​
external_id
string
required

This property was not properly documented

Response

200 - application/json

Ok

​
data
object
required
Example:
{
  "average_execution_price": 42600,
  "create_date": "2017-12-08T23:42:54.960Z",
  "external_id": "C90796F2-2CC3-4797-9AC3-A16BCC6936F0",
  "executed_amount": 0.02347418,
  "id": "8DE12108-4643-4E9F-8425-0172F1B96876",
  "remaining_amount": 0,
  "requested_amount": 0.02347418,
  "requested_value": 1000,
  "remaining_value": 0,
  "pair": "BTC_BRL",
  "price": 42600,
  "side": "buy",
  "status": "executed_completely",
  "fee": 0.002,
  "total_value": 1000,
  "type": "limit",
  "update_date": "2017-12-13T21:48:48.817Z",
  "transactions": [
    {
      "amount": 0.2,
      "create_date": "2020-02-21T20:24:43.433Z",
      "fee": 0.12,
      "fee_currency": "BTC",
      "price": 5000,
      "total_value": 1000
    },
    {
      "amount": 0.2,
      "create_date": "2020-02-21T20:49:37.450Z",
      "fee": 0.12,
      "fee_currency": "BTC",
      "price": 5000,
      "total_value": 1000
    }
  ]
}
​
error_code
number
required
Example:

null

​
message
string
required
Example:

null