Skip to main content
GET
/
trade
/
orders
Orders - User Orders
curl --request GET \
  --url https://api.ripio.com/trade/orders \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>'
{
  "data": {
    "orders": [
      {
        "create_date": "2017-12-08T23:42:54.960Z",
        "executed_amount": 0.02347418,
        "external_id": "B4A9F7F4-9C79-4921-9330-224C17260BDF",
        "id": "857C0A3B-D70F-4256-9051-1C62FADBA8FA",
        "pair": "BTC_BRL",
        "price": 42600,
        "remaining_amount": 0,
        "remaining_value": 0,
        "requested_amount": 0.02347418,
        "requested_value": 1000,
        "side": "buy",
        "status": "executed_completely",
        "total_value": 1000,
        "type": "limit",
        "update_date": "2017-12-13T21:48:48.817Z",
        "fee": 1
      },
      {
        "create_date": "2017-10-20T00:26:40.403Z",
        "executed_amount": 0.00033518,
        "external_id": "13080055-7357-4110-81B1-981E6699FA57",
        "id": "3ECBE371-DE24-42E8-841C-4281B3164CCE",
        "pair": "BTC_BRL",
        "price": 16352.12,
        "remaining_amount": 0,
        "remaining_value": 0,
        "requested_amount": 0.00033518,
        "requested_value": 5.48090358,
        "side": "buy",
        "status": "executed_completely",
        "total_value": 5.48090358,
        "type": "limit",
        "update_date": "2017-10-20T00:26:40.467Z",
        "fee": 1
      }
    ],
    "pagination": {
      "current_page": 1,
      "registers_count": 21,
      "total_pages": 1,
      "page_size": 100
    },
    "nc": "<string>",
    "pc": "<string>"
  },
  "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.

Query Parameters

​
pair
string
required

Currency pair code

Example:

"BTC_BRL"

​
status
string[]

Order status (string or string list separated by commas)

​
side
string

Order side (buy or sell)

​
type
string

Order type (limit, market, stop_limit, trailing, ceiling or iceberg)

​
ids
string

Identifiers list separated by commas (maximum of 10 identifiers)

Example:

"a6f7f8b3-e531-4522-810c-4f726f796b10,1594d0af-9239-466b-805b-a4f5df5f16d9"

​
start_date
string

Initial date filter in ISO-8601 format (shouldn't be before 2017-10-01)

​
end_date
string

Final date filter in ISO-8601 format (the interval between the initial and final date shouldn't be greater than 6 months)

​
page_size
number

Number of records per page

Example:

100

​
current_page
number

Page number for pagination

Example:

3

​
c
string

The c parameter is the cursor you should use to fetch the next page of results

Response

200 - application/json

Ok

​
data
object
required
​
error_code
number
required
Example:

null

​
message
string
required
Example:

null