API Reference
FAQSandbox Portal

List FX trades

post
https://api-exchange-now-beta.vertofx.com/fx/list

List FX trades for your company with pagination and optional filters for trade state, date range, source and target type, and payment IDs.

📘

Check your base URL

Each Verto service has its own host. Use the base URL shown in the endpoint definition on this page — do not reuse a host from another service.

Sandbox hosts end in -sandbox.vertofx.com; the matching production host replaces sandbox with beta. Sending a request to the wrong environment returns 403.

See URLs (Sandbox vs Production) for the full service-by-service list.



Query Params
int32
required

max records to return

int32
required

number of items to skip

Body Params
date-time

start date for filtering the list.

date-time

end date for filtering the list.

date-time

scheduled start date for filtering the list.

date-time

scheduled end date for filtering the list.

fromCurrencies
array of objects

specify the source currency list for fx orders.

fromCurrencies
toCurrencies
array of objects

specify the target currency list for fx orders.

toCurrencies
sources
array of objects

specify the sources for filtering the list.

sources
Allowed:
targets
array of objects

specify the targets for filtering the list.

targets
Allowed:
sourceTargetPairs
array of objects
sourceTargetPairs
number

specify the minimum amount from for filtering the list.

number

specify the maximum amount from for filtering the list.

string
length between 1 and 50

search the records.

state
object
paymentIds
array of strings
paymentIds
string of strings
string | null

filter orders by specific user record ID (admin only).

Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?
Privacy policy Terms of service

VertoFX Ltd (No. 10973066) designs and operates the VertoFX website and app. VertoFX is authorised by the Financial Conduct Authority under the Electronic Money Regulations 2011, Firm Reference 901073, for the issuing of electronic money. Database rights protect data on VertoFX website(s) (including pricing data).

Please Note: we do NOT and WILL not deal with unregulated exchanges or affiliates as this currently falls outside of our risk appetite.

© Verto 2026

All rights reserved Registered Office: 20-22 Wenlock Road, London, England, N1 7GU