Skip to main content
GET
/
trade
/
user
/
trades
User - Get User Trades
curl --request GET \
  --url https://api.ripio.com/trade/user/trades \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>'
{
  "data": {
    "trades": [
      {
        "amount": 0.00270754,
        "date": "2019-04-02T11:22:22.403Z",
        "fee": 0.25,
        "fee_currency": "USDC",
        "id": "488F9395-47ED-4924-98AB-C860E1733A03",
        "maker_order_id": "1FD30735-E055-4200-AD3D-007B02A5BA92",
        "pair_code": "BTC_USDC",
        "taker_or_maker": "maker",
        "price": 18550,
        "side": "sell",
        "taker_order_id": "DBC6D4AF-D454-46DF-80EC-E19528A0FB25",
        "timestamp": 1675708481219,
        "type": "market",
        "total_value": 50.22
      },
      {
        "amount": 0.0026938,
        "date": "2019-04-02T11:25:41.512Z",
        "fee": 0.00001347,
        "fee_currency": "BTC",
        "id": "C79ED37D-DC21-4D54-8AFC-4262347E3F8D",
        "maker_order_id": "F49F5BD8-3F5B-4364-BCEE-F36F62DB966A",
        "pair_code": "BTC_USDC",
        "taker_or_maker": "taker",
        "price": 18550,
        "side": "buy",
        "taker_order_id": "FEAB5CEC-7F9E-4F95-B67D-9E8D5C739BE3",
        "timestamp": 1675708481220,
        "type": "market",
        "total_value": 49.96
      }
    ],
    "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"

​
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

​
page_size
number

Number of records per page

Example:

100

​
current_page
number

Page number for pagination

Example:

3

​
order_id
string

Order id

Example:

"F49F5BD8-3F5B-4364-BCEE-F36F62DB966A"

​
external_id
string

External id

Example:

"90FcPa1Zm75"

​
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