Skip to main content
POST
https://apis.hopnow.io
/
v1
/
accounts
/
{account_id}
/
fx
/
quotes
/
{quote_id}
/
execute
Execute FX Quote
curl --request POST \
  --url https://apis.hopnow.io/v1/accounts/{account_id}/fx/quotes/{quote_id}/execute \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "account_id": "<string>",
  "quote_id": "<string>",
  "base_currency": "<string>",
  "quote_currency": "<string>",
  "side": "<string>",
  "base_amount": "<string>",
  "quote_amount": "<string>",
  "all_in_rate": "<string>",
  "status": "<string>",
  "executed_at": "<string>",
  "confirmed_at": "<string>",
  "created": "<string>",
  "updated": "<string>"
}

Path Parameters

account_id
string
required
The account’s external ID (starts with acc_)
quote_id
string
required
The FX quote’s external ID (starts with quote_)

Response

id
string
FX trade identifier (starts with trade_)
object
string
Always returns "fx_trade"
account_id
string
Account ID
quote_id
string
FX quote ID
base_currency
string
Base currency
quote_currency
string
Quote currency
side
string
Trade side: BUY or SELL
base_amount
string
Base currency amount (decimal)
quote_amount
string
Quote currency amount (decimal)
all_in_rate
string
All-in exchange rate (decimal)
status
string
Trade status: pending, confirmed, or failed
executed_at
string
ISO 8601 timestamp when trade was executed
confirmed_at
string
ISO 8601 timestamp when trade was confirmed
created
string
ISO 8601 timestamp when created
updated
string
ISO 8601 timestamp when last updated

Response Example

{
  "id": "trade_1234567890abcdef",
  "object": "fx_trade",
  "account_id": "acc_1234567890abcdef",
  "quote_id": "quote_1234567890abcdef",
  "base_currency": "USD",
  "quote_currency": "EUR",
  "side": "BUY",
  "base_amount": "1000.00",
  "quote_amount": "850.00",
  "all_in_rate": "0.8500",
  "status": "pending",
  "executed_at": "2024-01-15T10:00:00Z",
  "confirmed_at": null,
  "created": "2024-01-15T10:00:00Z",
  "updated": "2024-01-15T10:00:00Z"
}