Create a quote - OpenFX

Node.js

const url = 'https://api.openfx.com/v3/fx/quotes';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'X-Request-Signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    buyCurrency: 'USDC',
    sellCurrency: 'USD',
    sellAmount: '1000.00',
    quoteForSeconds: 3
  })
};

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

import requests, json, uuid

# Supply exactly one of buyAmount or sellAmount.
# sign_request mints a fresh 60s JWT AND the matching X-Request-Signature. See Authentication
url = 'https://api.openfx.com/v3/fx/quotes'
body = json.dumps({
    'buyCurrency': 'USDC',
    'sellCurrency': 'USD',
    'sellAmount': '1000.00',  # or 'buyAmount': '999.50'
}).encode()
headers, body = sign_request('POST', url, body)
quote = requests.post(
    url,
    headers={**headers, 'Idempotency-Key': str(uuid.uuid4())},
    data=body,
).json()

# quote['data']['quoteAmount'] is the server-computed counter-leg amount.

HttpResponse<String> response = Unirest.post("https://api.openfx.com/v3/fx/quotes")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"buyCurrency\": \"USDC\",\n  \"sellCurrency\": \"USD\",\n  \"sellAmount\": \"1000.00\",\n  \"quoteForSeconds\": 3\n}")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/quotes");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Idempotency-Key: <idempotency-key>");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"buyCurrency\": \"USDC\",\n  \"sellCurrency\": \"USD\",\n  \"sellAmount\": \"1000.00\",\n  \"quoteForSeconds\": 3\n}");

CURLcode ret = curl_easy_perform(hnd);

package main

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

func main() {

	url := "https://api.openfx.com/v3/fx/quotes"

	payload := strings.NewReader("{\n  \"buyCurrency\": \"USDC\",\n  \"sellCurrency\": \"USD\",\n  \"sellAmount\": \"1000.00\",\n  \"quoteForSeconds\": 3\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	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).
# Set OPENFX_JWT to a freshly-minted bearer token. See Authentication.
# Supply exactly one of buyAmount or sellAmount.
# This example anchors the sell side — you'll spend exactly $1000 USD.
curl -X POST https://api.openfx.com/v3/fx/quotes \
  -H "Authorization: Bearer $OPENFX_JWT" \
  -H "X-Request-Signature: $OPENFX_SIGNATURE" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "buyCurrency": "USDC",
    "sellCurrency": "USD",
    "sellAmount": "1000.00"
  }'

{
  "data": {
    "object": "quote",
    "id": "qte_3FfGK34vwMvVFDedyb2nkf",
    "buyCurrency": "USDC",
    "sellCurrency": "USD",
    "sellAmount": "1000.00",
    "quoteAmount": "999.80000001",
    "settlementWindow": "T0",
    "createdAt": "2026-04-28T10:00:00.000Z",
    "expiresAt": "2026-04-28T10:00:03.000Z"
  }
}

POST

/

v3

/

fx

/

quotes

Node.js

const url = 'https://api.openfx.com/v3/fx/quotes';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'X-Request-Signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    buyCurrency: 'USDC',
    sellCurrency: 'USD',
    sellAmount: '1000.00',
    quoteForSeconds: 3
  })
};

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

import requests, json, uuid

# Supply exactly one of buyAmount or sellAmount.
# sign_request mints a fresh 60s JWT AND the matching X-Request-Signature. See Authentication
url = 'https://api.openfx.com/v3/fx/quotes'
body = json.dumps({
    'buyCurrency': 'USDC',
    'sellCurrency': 'USD',
    'sellAmount': '1000.00',  # or 'buyAmount': '999.50'
}).encode()
headers, body = sign_request('POST', url, body)
quote = requests.post(
    url,
    headers={**headers, 'Idempotency-Key': str(uuid.uuid4())},
    data=body,
).json()

# quote['data']['quoteAmount'] is the server-computed counter-leg amount.

HttpResponse<String> response = Unirest.post("https://api.openfx.com/v3/fx/quotes")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"buyCurrency\": \"USDC\",\n  \"sellCurrency\": \"USD\",\n  \"sellAmount\": \"1000.00\",\n  \"quoteForSeconds\": 3\n}")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/quotes");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Idempotency-Key: <idempotency-key>");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"buyCurrency\": \"USDC\",\n  \"sellCurrency\": \"USD\",\n  \"sellAmount\": \"1000.00\",\n  \"quoteForSeconds\": 3\n}");

CURLcode ret = curl_easy_perform(hnd);

package main

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

func main() {

	url := "https://api.openfx.com/v3/fx/quotes"

	payload := strings.NewReader("{\n  \"buyCurrency\": \"USDC\",\n  \"sellCurrency\": \"USD\",\n  \"sellAmount\": \"1000.00\",\n  \"quoteForSeconds\": 3\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	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).
# Set OPENFX_JWT to a freshly-minted bearer token. See Authentication.
# Supply exactly one of buyAmount or sellAmount.
# This example anchors the sell side — you'll spend exactly $1000 USD.
curl -X POST https://api.openfx.com/v3/fx/quotes \
  -H "Authorization: Bearer $OPENFX_JWT" \
  -H "X-Request-Signature: $OPENFX_SIGNATURE" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "buyCurrency": "USDC",
    "sellCurrency": "USD",
    "sellAmount": "1000.00"
  }'

{
  "data": {
    "object": "quote",
    "id": "qte_3FfGK34vwMvVFDedyb2nkf",
    "buyCurrency": "USDC",
    "sellCurrency": "USD",
    "sellAmount": "1000.00",
    "quoteAmount": "999.80000001",
    "settlementWindow": "T0",
    "createdAt": "2026-04-28T10:00:00.000Z",
    "expiresAt": "2026-04-28T10:00:03.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

Idempotency-Key

string

required

Client-generated unique key to make a write operation safely retryable. UUID v4 recommended. See Idempotency.

Required string length: 1 - 255

Pattern: ^[a-zA-Z0-9_-]{1,255}$

Example:

"550e8400-e29b-41d4-a716-446655440000"

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"

Body

application/json

Lock the buy amount (you choose exactly what you'll receive)
Lock the sell amount (you choose exactly what you'll spend)

Locks a rate for a currency pair against one anchored side of the trade. The client supplies exactly one of buyAmount (the exact amount they want to receive) or sellAmount (the exact amount they want to spend); the server computes the unspecified side at the quoted rate. Unknown fields are rejected with 400 VALIDATION_BODY_FAILED.

buyCurrency

string

required

Currency to buy.

Pattern: ^[A-Z0-9]{2,15}$

Example:

"USDC"

sellCurrency

string

required

Currency to sell.

Pattern: ^[A-Z0-9]{2,15}$

Example:

"USDC"

buyAmount

string

required

Amount to buy, denominated in buyCurrency. Mutually exclusive with sellAmount.

Pattern: ^[0-9]+(\.[0-9]{1,8})?$

Example:

"1000"

sellAmount

string

Amount to sell, denominated in sellCurrency. Mutually exclusive with buyAmount.

Pattern: ^[0-9]+(\.[0-9]{1,8})?$

Example:

"1000"

quoteForSeconds

enum<number>

default:3

Requested quote expiry validity in seconds.

Available options:

3,

15,

30,

45,

60

Example:

3

settlementWindow

enum<string>

default:T0

Settlement window for the resulting trade. Defaults to T0 when omitted.

Available options:

IMMEDIATE,

T0,

T1,

T2

Example:

"T0"

Response

Quote created.

data

object

required

A time-limited foreign exchange quote that can be used to create a trade.

Show child attributes

⌘I