CrissCross

Getting Started

Accounts

Balances

Deposits

Withdrawals

Trading

# Request for Quote

Quotes can be requested by supplying a source currency, a destination currency, and either a source or destination amount.

## Query Paramters

- 'from' is used to denote the source currency parameter,
    
- to' is used to denote the destination currency parameter.
    

Either 'want' or 'have' can be supplied to indicate the requested trade volume. **You can't supply values for both.**

- 'want' denotes the desired amount of destination currency.
    
- 'have' denotes the amount of source currency that is desired to be traded.
    

## Response

The following data is returned in the response body:

- The source and destination currencies that were requested in the query parameters.
    
- The trade rate (in source currency).
    
- A quote token that can be used to lock a trade.
    
- Timestamp of when the quote expires.
    
- Timestamp of when the quote is requested.

Request for Quote

# Accept Quote

Once you have requested a quote and wish to accept it, you can use the Quote ID you receive to lock the trade.

## Body

- The Quote ID received from the /quote endpoint.
    

## Response

The following data is returned in the response body:

- Order ID.
- The source and destination currencies that were requested in the quote.
- The trade rate (in source currency).
- Quantity of destination currency traded.
- Timestamp of when the trade was locked.
- Fee

Accept Quote

Endpoints specific to querying order history.

History

Payouts

Create Payout (Single)

Create Payout (Bulk)

Default

CrissCross API's

source

Explore CrissCross APIs to power global money movement with ease. From brokerage and trading to secure, fast payouts, our APIs simplify cross-border transactions, bringing financial systems into the borderless era.

CrissCross APIs | Global Payments & Money Movement Solutions

Production

Sandbox

<p class="slate-p " ></p><h2 class="slate-h2 " >API Overview</h2><p class="slate-p " ></p><p class="slate-p " >The CrissCross API provides comprehensive tools for managing accounts, trading currencies, and making local currency payouts. The API is organized into three main sections: <strong class="slate-bold">Accounts</strong>, <strong class="slate-bold">Trading</strong>, and <strong class="slate-bold">Payouts</strong>, allowing you to handle everything from deposits and withdrawals to currency conversion and local payouts.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Products and Functionality</h2><p class="slate-p " ></p><h3 class="slate-h3 " >1. Accounts</h3><p class="slate-p " >The Accounts section centralises balance management, deposits, and withdrawals, supporting both <strong class="slate-bold">trading</strong> and <strong class="slate-bold">payouts</strong>. This section provides essential endpoints to manage your funds effectively across multiple currencies.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Balances</strong>: View available, locked, and total balances.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Deposits</strong>: Fund your account with <strong class="slate-bold">supported currencies </strong>(Listed below).</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Withdrawals</strong>: Withdraw funds to your bank account or crypto wallet.</div></li></ul><p class="slate-p " ></p><h3 class="slate-h3 " >2. Trading</h3><p class="slate-p " >The Trading API enables you to convert between major and local currencies. Start by obtaining a quote, and once accepted, initiate the trade to move funds between currencies.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Get Quote</strong>: Retrieve a conversion rate and a <span style="background-color:#D9D9D9;"><code class="slate-code">quote_id</code></span> for a desired trade.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Accept Quote</strong>: Lock in the rate by accepting the quote within the valid timeframe to create the trade.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">History</strong>: View past trades for reference and auditing.</div></li></ul><p class="slate-p " ><strong class="slate-bold">Use Case</strong>: Ideal for businesses requiring high-volume currency conversions or managing funds across different currencies.</p><p class="slate-p " ></p><h3 class="slate-h3 " >3. Payouts</h3><p class="slate-p " >The Payouts API is designed for distributing funds across regions, supporting both bank and mobile wallet transfers. The Payouts API works alongside the Trading and Accounts sections to ensure sufficient local currency balances for payouts.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Single and Bulk Payouts</strong>: Send individual or batch payouts to bank accounts or mobile wallets.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Payout History</strong>: Track previous payouts by filtering for a specific payout ID or date range.</div></li></ul><p class="slate-p " ><strong class="slate-bold">Use Case</strong>: Useful for businesses that manage regular disbursements or large volumes of regional payouts.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Workflow Overview</h2><p class="slate-p " ></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Fund Account</strong>: Start by funding your CrissCross account with supported currency via the <strong class="slate-bold">Deposit Endpoint</strong> in Accounts.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Check Balances</strong>: Use the <strong class="slate-bold">Balances Endpoint</strong> to view all account balances.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Trade</strong>: Convert funds from major currencies to local currencies or vice versa using the <strong class="slate-bold">Trading Endpoint.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Make Payouts</strong>: If you have sufficient balance in a supported payout currency you can initiate single or bulk payouts to recipients using the <strong class="slate-bold">Payouts Endpoint</strong>.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Track Payouts</strong>: View payout transaction history with the <strong class="slate-bold">Payout History Endpoint</strong> for tracking and auditing.</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Authentication</h2><p class="slate-p " ></p><p class="slate-p " >To access the CrissCross API, include an API key in each request header as <span style="background-color:#D9D9D9;"><code class="slate-code">apiKey</code></span>. If you need an API key, contact your account manager or <a href="https://desktop.postman.com/?desktopVersion=11.18.0&webVersion=11.18.0-ui-241015-0634&userId=7215392&teamId=3835382&region=us" target="_blank">info@crisscross.money</a>.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Content-Type</strong>: Use <span style="background-color:#D9D9D9;"><code class="slate-code">application/json</code></span> for all requests.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">HTTPS Only</strong>: Non-secure requests are not supported.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Error Handling</strong>: Successful requests return an HTTP status code in the 200 range. Unauthorized requests return a 403 error.</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Supported Currencies</h2><p class="slate-p " ></p><p class="slate-p " >The list of supported currencies is regularly updated to meet expanding market needs.</p><h3 class="slate-h3 " >Fiat</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Major Currencies</strong>: USD, EUR</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Minor Currencies</strong>: NGN, XOF, XAF, GHS, KES, ZAR, AED, EGP, SAR</div></li></ul><p class="slate-p " ></p><h3 class="slate-h3 " >Crypto</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Supported Currencies</strong>: USDT, USDC, BTC</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Supported Networks</strong>: ERC20, TRC20, BTC</div></li></ul><p class="slate-p " ></p><h3 class="slate-h3 " >Notes</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Payouts are only supported in <strong class="slate-bold">Minor Currencies</strong>.</div></li><li class="slate-li " ><div style="position:relative">Direct trades between minor currencies (e.g., XOF to NGN) are not supported via the API. If you require trading between minor currencies, this can be arranged over-the-counter (OTC). Please contact us at <a href="https://desktop.postman.com/?desktopVersion=11.18.0&webVersion=11.18.0-ui-241015-0634&userId=7215392&teamId=3835382&region=us" target="_blank">info@crisscross.money</a> for more information.</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Access and Usage</h2><p class="slate-p " ></p><p class="slate-p " >The CrissCross API is governed by our Terms of Service. Ensure you have read and accepted these terms before integrating with our platform.</p><p class="slate-p " >For any questions, feedback, or recommendations, please contact us at
<a href="mailto:info@crisscross.money" target="_self">info@crisscross.money</a>.</p><p class="slate-p " ></p><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><p class="slate-p " ></p>

The CrissCross API provides comprehensive tools for managing accounts, trading currencies, and making local currency payouts. The API is organized into three main sections: 

, allowing you to handle everything from deposits and withdrawals to currency conversion and local payouts.

The Accounts section centralises balance management, deposits, and withdrawals, supporting both 

. This section provides essential endpoints to manage your funds effectively across multiple currencies.

The Trading API enables you to convert between major and local currencies. Start by obtaining a quote, and once accepted, initiate the trade to move funds between currencies.

: Ideal for businesses requiring high-volume currency conversions or managing funds across different currencies.

The Payouts API is designed for distributing funds across regions, supporting both bank and mobile wallet transfers. The Payouts API works alongside the Trading and Accounts sections to ensure sufficient local currency balances for payouts.

: Useful for businesses that manage regular disbursements or large volumes of regional payouts.

To access the CrissCross API, include an API key in each request header as 

. If you need an API key, contact your account manager or 

The list of supported currencies is regularly updated to meet expanding market needs.

The CrissCross API is governed by our Terms of Service. Ensure you have read and accepted these terms before integrating with our platform.

For any questions, feedback, or recommendations, please contact us at


<p class="slate-p " ></p><p class="slate-p " >These endpoints support both trading and payout operations, giving you a unified view and control over your funds across various currencies.</p><p class="slate-p " ></p><h4 class="slate-h4 " >Key Endpoints</h4><p class="slate-p " ></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Balances</strong>: Check available, locked, and total balances across all supported currencies. This endpoint provides a complete view of your funds held with CrissCross.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Deposits</strong>: Fund your account with our <a href="6720fe58b15bb1a28620c034" target="">supported fiat and cryptocurrencies</a>.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Withdrawals</strong>: Access funds from your CrissCross account by initiating withdrawals to a bank or crypto wallet.</div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p>

These endpoints support both trading and payout operations, giving you a unified view and control over your funds across various currencies.

<p class="slate-p " ></p><p class="slate-p " >The Trading API allows you to execute currency conversions between major and local currencies. Follow these steps to create a trade:</p><p class="slate-p " ><strong class="slate-bold">Step 1</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Get a Quote</strong>: Start by retrieving a quote for the currency conversion.</div></li><li class="slate-li " ><div style="position:relative">The API will respond with a <span style="background-color:#D9D9D9;"><code class="slate-code">quote_id</code></span> and the applicable conversion rate. <strong class="slate-bold">Note:</strong> The quote is valid for 5 seconds.</div></li></ul><p class="slate-p " ><strong class="slate-bold">Step 2</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Accept the Quote</strong>: To lock in the rate and create the trade, you need to accept the quote using the <span style="background-color:#D9D9D9;"><code class="slate-code">quote_id</code></span>.</div></li></ul><p class="slate-p slate-indent-0-1" style="NaNpx"></p><h4 class="slate-h4 " >Use the Trading API to:</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Access live rates for supported currency pairs</div></li><li class="slate-li " ><div style="position:relative">Request quotes and lock trades</div></li><li class="slate-li " ><div style="position:relative">View your order history</div></li></ul><p class="slate-p slate-indent-0" style="0px"></p>

The Trading API allows you to execute currency conversions between major and local currencies. Follow these steps to create a trade:

<p class="slate-p " >Quotes can be requested by supplying a source currency, a destination currency, and either a source or destination amount. <strong class="slate-bold">Quotes expire after 5 seconds.</strong></p><p class="slate-p " ></p><h2 class="slate-h2 " >Query Parameters</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">&apos;from&apos; is used to denote the source currency parameter,</div></li><li class="slate-li " ><div style="position:relative">&apos;to&apos; is used to denote the destination currency parameter.</div></li></ul><p class="slate-p " >Either &apos;want&apos; or &apos;have&apos; can be supplied to indicate the requested trade volume. <strong class="slate-bold">You can&apos;t supply values for both.</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">&apos;want&apos; denotes the desired amount of destination currency.</div></li><li class="slate-li " ><div style="position:relative">&apos;have&apos; denotes the amount of source currency that is desired to be traded.</div></li></ul><p class="slate-p " ></p><h2 class="slate-h2 " >Response</h2><p class="slate-p " >The following data is returned in the response body:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">The source and destination currencies that were requested in the query parameters.</div></li><li class="slate-li " ><div style="position:relative">The trade rate (in source currency).</div></li><li class="slate-li " ><div style="position:relative">A quote token that can be used to lock a trade.</div></li><li class="slate-li " ><div style="position:relative">Timestamp of when the quote expires.</div></li><li class="slate-li " ><div style="position:relative">Timestamp of when the quote is requested.</div></li></ul><p class="slate-p " ></p>

Quotes can be requested by supplying a source currency, a destination currency, and either a source or destination amount. 

Either 'want' or 'have' can be supplied to indicate the requested trade volume. 

The following data is returned in the response body:

The API key used for authentication purposes.

apiKey

from

have

from_currency

The amount of currency being traded from.

from_amount

The currency to which the trade will be made.

to_currency

to_amount

The trade rate represents the exchange rate used for the quote calculation.

trade_rate

The inverse of the trade rate used for the quote calculation.

trade_rate_inverse

The spot rate used for the quote calculation.

spot_rate

The inverse of the spot rate used for the quote calculation.

spot_rate_inverse

Indicates the type of quote request being made.

type

quote_id

The date and time when the quote request was created.

created_at

The expiration date and time of the quote request.

expires_at

<p class="slate-p " >Once you have requested a quote and wish to accept it, <strong class="slate-bold">you have 5 seconds</strong> to use the Quote ID you received to lock the trade.</p><p class="slate-p " ></p><h2 class="slate-h2 " >Body</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">The Quote ID received from the /quote endpoint.</div></li></ul><p class="slate-p " ></p><h2 class="slate-h2 " >Response</h2><p class="slate-p " >The following data is returned in the response body:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Order ID.</div></li><li class="slate-li " ><div style="position:relative">The source and destination currencies that were requested in the quote.</div></li><li class="slate-li " ><div style="position:relative">The trade rate (in source currency).</div></li><li class="slate-li " ><div style="position:relative">Quantity of destination currency traded.</div></li><li class="slate-li " ><div style="position:relative">Timestamp of when the trade was locked.</div></li></ul><p class="slate-p " ></p>

Once you have requested a quote and wish to accept it, 

 to use the Quote ID you received to lock the trade.

The unique identifier for the order associated with the quote.

order_id

The currency from which the amount is originating.

The currency to which the amount will be received.

The amount to be received in the "to" currency.

The trade rate at which the quote is accepted.

The inverse of the trade rate for the quote.

The spot rate at which the quote is based.

The inverse of the spot rate for the quote.

The timestamp indicating when the quote was created.

<p class="slate-p " >Endpoints specific to querying order history.</p><p class="slate-p " ></p>

<p class="slate-p " ></p><p class="slate-p " >Query order history.</p><h2 class="slate-h2 " >Query Parameters</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Perform time-based filtering using start_time and end_time. Supplying a start_time will return all orders that occurred *after* that timestamp. Supplying an end_time will return all orders that occurred *before* that timestamp.</div></li><li class="slate-li " ><div style="position:relative">To is the source currency of the order.</div></li><li class="slate-li " ><div style="position:relative">From is the destination currency of the order.</div></li></ul><p class="slate-p " ></p><h2 class="slate-h2 " >Response</h2><p class="slate-p " >A list of orders is returned. For each order, the following data is returned.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Order ID.</div></li><li class="slate-li " ><div style="position:relative">The source and destination currencies that were requested in the quote.</div></li><li class="slate-li " ><div style="position:relative">The trade rate (in source currency).</div></li><li class="slate-li " ><div style="position:relative">Quantity of destination currency traded.</div></li><li class="slate-li " ><div style="position:relative">Timestamp of when the trade was locked.</div></li></ul><p class="slate-p " ></p>

A list of orders is returned. For each order, the following data is returned.

Order History (Multiple)

UNIX timestamp (UTC) that defines the start of the request window. All trades that occured after this timestamp are returned.

start_time

UNIX timestamp (UTC) that defines the end of the request window. All trades that occured before this timestamp are returned.

end_time

<p class="slate-p " >Query data relating to a single order. Supply the order ID as a path parameter.</p><p class="slate-p " ></p><h2 class="slate-h2 " >Response</h2><p class="slate-p " >A single order is returned. The following data is returned.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Order ID.</div></li><li class="slate-li " ><div style="position:relative">The source and destination currencies that were requested in the quote.</div></li><li class="slate-li " ><div style="position:relative">The trade rate (in source currency).</div></li><li class="slate-li " ><div style="position:relative">Quantity of destination currency traded.</div></li><li class="slate-li " ><div style="position:relative">Timestamp of when the trade was locked.</div></li></ul><p class="slate-p " ></p>

Query data relating to a single order. Supply the order ID as a path parameter.

A single order is returned. The following data is returned.

Order History (Single)

The currency from which the amount is converted.

The currency to which the amount is converted.

The timestamp when the order was created.

<p class="slate-p " ></p><p class="slate-p " >The Payouts API enables you to send funds to recipients in supported regions via bank accounts or mobile wallets (MoMo). Whether handling individual transactions or large-volume disbursements, the Payouts API provides the flexibility to manage payouts reliably and efficiently.</p><p class="slate-p " ></p><h4 class="slate-h4 " >Key Features</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Single Payouts</strong>: Send a one-time payout to a recipient’s bank account or mobile wallet.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Bulk Payouts</strong>: Schedule multiple payouts in a single request, ideal for handling larger batches of disbursements.</div></li></ul><p class="slate-p " ></p><h4 class="slate-h4 " >Workflow</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Check Balance</strong>: Use the <a href="67236b1cca7ad07ebffee1af/671a535d31d0246ab92ac310/671a535d31d0246ab92ac312" target=""><strong class="slate-bold">Balances Endpoint</strong> </a>to confirm sufficient funds in the payout currency.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Top-up Account (if needed)</strong>: Convert from major currencies to the local currency using the <a href="671a535d31d0246ab92ac2fc" target=""><strong class="slate-bold">Trading</strong></a> endpoint.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Initiate Payout</strong>: Send funds using either the single or bulk payout endpoints, depending on your needs.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Track Payout History</strong>: Use the <strong class="slate-bold">Payout History Endpoint</strong> to monitor and review payout transactions, with options to filter by date range or specific payout ID.</div></li></ul><p class="slate-p " ></p><p class="slate-p " >The Payouts API is built for businesses that need to move money across regions reliably, whether for operational payments, customer disbursements, or payroll.</p><p class="slate-p " ></p>

The Payouts API enables you to send funds to recipients in supported regions via bank accounts or mobile wallets (MoMo). Whether handling individual transactions or large-volume disbursements, the Payouts API provides the flexibility to manage payouts reliably and efficiently.

The Payouts API is built for businesses that need to move money across regions reliably, whether for operational payments, customer disbursements, or payroll.

Sections