List currency pairs

Node.js

const url = 'https://api.openfx.com/v3/fx/pairs';
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
url = 'https://api.openfx.com/v3/fx/pairs'
headers, _ = sign_request('GET', url)
res = requests.get(url, headers={**headers})
pairs = res.json()['data']

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/pairs");

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/pairs"

	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/pairs \
  -H "Authorization: Bearer $OPENFX_JWT" \
  -H "X-Request-Signature: $OPENFX_SIGNATURE"

{
  "data": {
    "pairs": [
      {
        "buyCurrency": "USDC",
        "sellCurrency": "USD",
        "minTradeAmount": "10.00",
        "maxTradeAmount": "1000000.00"
      },
      {
        "buyCurrency": "USD",
        "sellCurrency": "USDC",
        "minTradeAmount": "10.000000",
        "maxTradeAmount": "1000000.000000"
      },
      {
        "buyCurrency": "USDC",
        "sellCurrency": "EUR",
        "minTradeAmount": "10.00",
        "maxTradeAmount": "1000000.00"
      }
    ]
  }
}

GET

pairs

Node.js

const url = 'https://api.openfx.com/v3/fx/pairs';
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
url = 'https://api.openfx.com/v3/fx/pairs'
headers, _ = sign_request('GET', url)
res = requests.get(url, headers={**headers})
pairs = res.json()['data']

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/pairs");

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/pairs"

	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/pairs \
  -H "Authorization: Bearer $OPENFX_JWT" \
  -H "X-Request-Signature: $OPENFX_SIGNATURE"

{
  "data": {
    "pairs": [
      {
        "buyCurrency": "USDC",
        "sellCurrency": "USD",
        "minTradeAmount": "10.00",
        "maxTradeAmount": "1000000.00"
      },
      {
        "buyCurrency": "USD",
        "sellCurrency": "USDC",
        "minTradeAmount": "10.000000",
        "maxTradeAmount": "1000000.000000"
      },
      {
        "buyCurrency": "USDC",
        "sellCurrency": "EUR",
        "minTradeAmount": "10.00",
        "maxTradeAmount": "1000000.00"
      }
    ]
  }
}

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"

Response

List of currency pairs.

data

object

required

The complete bounded collection of tradable currency pairs available to your organization. Limits are scoped to the sellCurrency, so each underlying pair is enumerated in both directions.

Show child attributes

⌘I

Trade

Trade Settlement

Exposure

List currency pairs

Authorizations

Headers

Response