Retrieve a trade - OpenFX

Node.js

const url = 'https://api.openfx.com/v3/fx/trades/{id}';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Request-Signature': '<api-key>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests
# sign_request mints a fresh 60s JWT AND the matching X-Request-Signature. See Authentication
trade_id = 'tde_5W7guYdHT24JFnRQrZN9y8'
url = f'https://api.openfx.com/v3/fx/trades/{trade_id}'
headers, _ = sign_request('GET', url)
trade = requests.get(url, headers={**headers}).json()

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/trades/{id}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v3/fx/trades/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

# X-Request-Signature is an ES256 signature; compute it with one of the
# language helpers in /v3/authentication (shell signing is impractical).
curl https://api.openfx.com/v3/fx/trades/tde_5W7guYdHT24JFnRQrZN9y8 \
  -H "Authorization: Bearer $OPENFX_JWT" \
  -H "X-Request-Signature: $OPENFX_SIGNATURE"

{
  "data": {
    "object": "trade",
    "id": "tde_5W7guYdHT24JFnRQrZN9y8",
    "quoteId": "qte_3FfGK34vwMvVFDedyb2nkf",
    "buyCurrency": "USDC",
    "sellCurrency": "USD",
    "executedAmount": "999.8",
    "status": "EXECUTED",
    "clientReferenceId": "order-123",
    "createdAt": "2026-04-28T10:00:00.000Z",
    "settlementWindow": "T0",
    "settlementStartTime": "2026-04-28T10:00:30.000Z"
  }
}

GET

/

v3

/

fx

/

trades

/

{id}

Node.js

const url = 'https://api.openfx.com/v3/fx/trades/{id}';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Request-Signature': '<api-key>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests
# sign_request mints a fresh 60s JWT AND the matching X-Request-Signature. See Authentication
trade_id = 'tde_5W7guYdHT24JFnRQrZN9y8'
url = f'https://api.openfx.com/v3/fx/trades/{trade_id}'
headers, _ = sign_request('GET', url)
trade = requests.get(url, headers={**headers}).json()

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/trades/{id}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v3/fx/trades/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

# X-Request-Signature is an ES256 signature; compute it with one of the
# language helpers in /v3/authentication (shell signing is impractical).
curl https://api.openfx.com/v3/fx/trades/tde_5W7guYdHT24JFnRQrZN9y8 \
  -H "Authorization: Bearer $OPENFX_JWT" \
  -H "X-Request-Signature: $OPENFX_SIGNATURE"

{
  "data": {
    "object": "trade",
    "id": "tde_5W7guYdHT24JFnRQrZN9y8",
    "quoteId": "qte_3FfGK34vwMvVFDedyb2nkf",
    "buyCurrency": "USDC",
    "sellCurrency": "USD",
    "executedAmount": "999.8",
    "status": "EXECUTED",
    "clientReferenceId": "order-123",
    "createdAt": "2026-04-28T10:00:00.000Z",
    "settlementWindow": "T0",
    "settlementStartTime": "2026-04-28T10:00:30.000Z"
  }
}

Authorizations

Authorization

string

header

required

ES256-signed JWT bearer token, single-use, 60-second TTL. See Authentication for how to mint one.

X-Request-Signature

string

header

required

ES256 signature over the request, bound to the bearer JWT. Required on every v3 request. See Authentication → Request signing.

Headers

X-Request-Id

string

Optional, client-supplied correlation ID for this request. Echoed verbatim on the response when supplied; the response omits it when the request did not supply one. Distinct from X-Trace-Id (server-generated, always present). See Metadata & tracing.

Example:

"my-req-abc-123"

Path Parameters

id

string

required

Trade ID. Accepts either the current readable, typed-prefix ID (see ResourceId) or a legacy bare UUID v4, for backward compatibility with IDs persisted before v3 introduced readable IDs. Both forms resolve to the same underlying record. Responses always return the readable form — see Resource IDs.

Pattern: ^([a-z]{3,5}_[1-9A-HJ-NP-Za-km-z]{1,22}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$

Example:

"tde_5W7guYdHT24JFnRQrZN9y8"

Response

The trade.

data

object

required

A trade executes against a quote at the quoted rate.

Show child attributes

⌘I