Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
fx
/
trades
List FX Trades
curl --request GET \
  --url https://api.hopnow.io/v1/accounts/{account_id}/fx/trades \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "<string>",
      "object": "<string>",
      "account_id": "<string>",
      "quote_id": "<string>",
      "source_currency": "<string>",
      "target_currency": "<string>",
      "amount_type": "<string>",
      "source_amount": "<string>",
      "target_amount": "<string>",
      "all_in_rate": "<string>",
      "status": "<string>",
      "trade_type": "<string>",
      "executed_at": "<string>",
      "note": "<string>",
      "created": "<string>",
      "updated": "<string>"
    }
  ],
  "page": 123,
  "size": 123,
  "total": 123,
  "pages": 123
}

​
Path Parameters

​
account_id
string
required
The account’s external ID (starts with acc_)

​
Query Parameters

​
start_date
string
Filter trades created on or after this date (ISO 8601 format)
​
end_date
string
Filter trades created before this date (ISO 8601 format)
​
page
integer
default:"1"
Page number (minimum 1)
​
size
integer
default:"10"
Items per page (1-100)

​
Response

​
items
array
Array of FX trade objects
​
page
integer
Current page number
​
size
integer
Items per page
​
total
integer
Total number of items
​
pages
integer
Total number of pages

​
Response Example

{
  "items": [
    {
      "id": "fxt_1234567890abcdef",
      "object": "fx_trade",
      "account_id": "acc_1234567890abcdef",
      "quote_id": "fxq_1234567890abcdef",
      "source_currency": "USD",
      "target_currency": "EUR",
      "amount_type": "source",
      "source_amount": "1000.00",
      "target_amount": "855.69",
      "all_in_rate": "0.85569",
      "status": "completed",
      "trade_type": "market",
      "executed_at": "2024-01-15T10:00:30Z",
      "note": null,
      "created": "2024-01-15T10:00:30Z",
      "updated": "2024-01-15T10:00:30Z"
    }
  ],
  "page": 1,
  "size": 10,
  "total": 1,
  "pages": 1
}