List deposits

GET

deposits

Node.js

const url = 'https://api.openfx.com/v3/fx/deposits';
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 each call.
# Sign per page because the JWT TTL is 60s and can lapse mid back-fill, and the
# signature is bound to the request URL. See Rate limiting -> Handling rate limits pattern:
# https://docs.openfx.com/v3/rate-limiting#handling-rate-limits-pattern
cursor, all_deposits = None, []
while True:
    params = {'limit': 100}
    if cursor: params['startingAfter'] = cursor
    prepared = requests.Request('GET', 'https://api.openfx.com/v3/fx/deposits', params=params).prepare()
    headers, _ = sign_request('GET', prepared.url)
    page = requests.get(prepared.url, headers={**headers}).json()
    all_deposits.extend(page['data'])
    cursor = page['pagination']['nextCursor']  # opaque token; None on the last page
    if cursor is None: break

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

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

	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))

}

{
  "data": [
    {
      "object": "deposit",
      "id": "dpt_EA9vbVngB76PmMibCiMNPb",
      "currency": "USD",
      "assetType": "FIAT",
      "depositAmount": "10000.00",
      "status": "COMPLETED",
      "network": null,
      "transactionHash": null,
      "referenceId": "Deposit from XYZ",
      "memo": null,
      "paymentDetails": {
        "FEDWIRE": {
          "imad": "20260428B1QGC07C001234",
          "omad": "20260428L1B7012C003456"
        }
      },
      "createdAt": "2026-04-28T09:50:00.000Z"
    },
    {
      "object": "deposit",
      "id": "dpt_GGNnm66gppS3syB6J4irne",
      "currency": "USDC",
      "assetType": "CRYPTO",
      "depositAmount": "5000.00",
      "status": "COMPLETED",
      "network": "ETHEREUM",
      "transactionHash": "0xabc123def4567890abcdef1234567890abcdef1234567890abcdef123456789",
      "referenceId": null,
      "memo": null,
      "paymentDetails": null,
      "createdAt": "2026-03-22T11:50:00.000Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "hasNext": false,
    "nextCursor": null,
    "hasPrev": false,
    "prevCursor": null
  }
}

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

X-App-Mode

enum<string>

default:SANDBOX

Environment selector, matching the API key's bound environment. Defaults to SANDBOX when omitted. See Environments. When present, the value must be SANDBOX or LIVE, matched without regard to case. Any other value, including an empty one, returns 400 INVALID_APP_MODE; details.received echoes the value you sent.

Available options:

SANDBOX,

LIVE

Example:

"SANDBOX"

Query Parameters

limit

integer

default:25

Max records to return. Range 1–100. Default 25.

Required range: 1 <= x <= 100

Example:

50

startingAfter

string

An opaque cursor string from a previous response's pagination.nextCursor. Fetches the page of records older than the cursor's position (lists are sorted newest-first). Cursors are opaque — pass them back verbatim, do not decode or modify them. Mutually exclusive with endingBefore.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA3VDEzOjAyOjI5LjE0N1oiLCJpZCI6IjZhOGRmZjAzLWFiY2QtNDEyMy1iYWNkLTAxMjM0NTY3ODlhYiJ9"

endingBefore

string

An opaque cursor string from a previous response's pagination.prevCursor. Fetches the page of records newer than the cursor's position. Cursors are opaque — pass them back verbatim, do not decode or modify them. Mutually exclusive with startingAfter.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDA5OjE1OjAwLjAwMFoiLCJpZCI6ImExMmJjMzQ1LWQ2ZTctNDg5MC1iY2RlLWZlZGNiYTk4NzY1NCJ9"

currency

enum<string>

Filter deposits by a supported currency code, for example USDC or USD. A code that is not supported returns 400 VALIDATION_QUERY_FAILED. Filter by a supported deposit currency.

Available options:

USD,

AED,

GBP,

EUR,

AUD,

MXN,

BRL,

PHP,

ARS,

COP,

INR,

CHF,

IDR,

NOK,

PLN,

SGD,

ZAR,

DKK,

HKD,

SEK,

USDT,

USDC,

EURC,

EUROP

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

Example:

"USDC"

Response

Paginated list of deposits.

A paginated collection of deposit resources.

data

object[]

required

Deposit resources returned in this page, sorted newest first.

Show child attributes

pagination

object

required

Pagination envelope for unbounded list responses. hasNext / hasPrev are the explicit "is there another page in this direction" booleans; nextCursor / prevCursor are the opaque cursors you pass back verbatim via the startingAfter / endingBefore query parameters. When hasNext is false the nextCursor is null (you are on the last page); likewise hasPrev / prevCursor on the first page.

Show child attributes

⌘I

Node.js

const url = 'https://api.openfx.com/v3/fx/deposits';
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 each call.
# Sign per page because the JWT TTL is 60s and can lapse mid back-fill, and the
# signature is bound to the request URL. See Rate limiting -> Handling rate limits pattern:
# https://docs.openfx.com/v3/rate-limiting#handling-rate-limits-pattern
cursor, all_deposits = None, []
while True:
    params = {'limit': 100}
    if cursor: params['startingAfter'] = cursor
    prepared = requests.Request('GET', 'https://api.openfx.com/v3/fx/deposits', params=params).prepare()
    headers, _ = sign_request('GET', prepared.url)
    page = requests.get(prepared.url, headers={**headers}).json()
    all_deposits.extend(page['data'])
    cursor = page['pagination']['nextCursor']  # opaque token; None on the last page
    if cursor is None: break

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

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

	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))

}

{
  "data": [
    {
      "object": "deposit",
      "id": "dpt_EA9vbVngB76PmMibCiMNPb",
      "currency": "USD",
      "assetType": "FIAT",
      "depositAmount": "10000.00",
      "status": "COMPLETED",
      "network": null,
      "transactionHash": null,
      "referenceId": "Deposit from XYZ",
      "memo": null,
      "paymentDetails": {
        "FEDWIRE": {
          "imad": "20260428B1QGC07C001234",
          "omad": "20260428L1B7012C003456"
        }
      },
      "createdAt": "2026-04-28T09:50:00.000Z"
    },
    {
      "object": "deposit",
      "id": "dpt_GGNnm66gppS3syB6J4irne",
      "currency": "USDC",
      "assetType": "CRYPTO",
      "depositAmount": "5000.00",
      "status": "COMPLETED",
      "network": "ETHEREUM",
      "transactionHash": "0xabc123def4567890abcdef1234567890abcdef1234567890abcdef123456789",
      "referenceId": null,
      "memo": null,
      "paymentDetails": null,
      "createdAt": "2026-03-22T11:50:00.000Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "hasNext": false,
    "nextCursor": null,
    "hasPrev": false,
    "prevCursor": null
  }
}

Core concepts

Endpoints

Webhooks

Authorizations

Headers

Query Parameters

Response