Exchange

Getting Started with Exchange

Convert currencies seamlessly across fiat and stablecoin rails

The CrissCross Exchange API provides comprehensive tools for managing accounts, trading currencies, and making local currency payouts. Convert currencies seamlessly across fiat and stablecoin rails, get faster settlement, full visibility via API, and access a custom dashboard. The API is organized into three main sections: Accounts, Trading, and Payouts, allowing you to handle everything from deposits and withdrawals to currency conversion and local payouts.

Products and Functionality

1. Accounts

The Accounts section centralises balance management, deposits, and withdrawals, supporting both trading and payouts. This section provides essential endpoints to manage your funds effectively across multiple currencies.

  • Balances: View available, locked, and total balances.
  • Deposits: Fund your account with supported currencies (Listed below).
  • Withdrawals: Withdraw funds to your bank account or crypto wallet.

2. Trading

The Trading API enables you to convert between major and local currencies seamlessly across fiat and stablecoin rails. Start by obtaining a quote, and once accepted, initiate the trade to move funds between currencies. Get the most competitive FX rates on every transaction.

  • Get Quote: Retrieve a conversion rate and a quote_id for a desired trade.
  • Accept Quote: Lock in the rate by accepting the quote within the valid timeframe to create the trade.
  • History: View past trades for reference and auditing.

Use Case: Ideal for businesses requiring high-volume currency conversions or managing funds across different currencies. Perfect for merchants who need to convert collected funds to their preferred settlement currency.

3. Payouts

Use Exchange to convert funds, then use the Payouts product to disburse to bank accounts or mobile wallets.

  • Single and Bulk Payouts: Send individual or batch payouts through Payouts.
  • Payout History: Track previous payouts by payout ID or date range.

Use Case: Exchange for FX, Payouts for disbursements. See Payouts Getting Started.

Workflow Overview

  • Fund Account: Start by funding your CrissCross account with supported currency via the Deposit Endpoint in Accounts.
  • Check Balances: Use the Balances Endpoint to view all account balances.
  • Trade: Convert funds between supported fiat currencies or between fiat and stablecoins using the Trading Endpoint.
  • Make Payouts: With sufficient local balance, initiate payouts through Payouts.
  • Track Payouts: View payout history in Payouts for tracking and auditing.

Authentication

All Exchange API requests require OAuth 2.0 authentication. You obtain an access token by calling the Authentication endpoint with your merchantId and clientSecret, then include the token in the Authorization: Bearer ... header on subsequent requests.

For detailed authentication instructions, see the Authentication guide.

Supported Currencies

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

Fiat

  • Fiat Currencies: USD, EUR, NGN, XOF, XAF, GHS, KES, ZAR, AED, EGP, SAR

Crypto

  • Supported Currencies: USDT, USDC, BTC
  • Supported Networks: ERC20, TRC20, BTC

Notes

  • Payouts are supported in fiat currencies and Stablecoins (USDT, USDC).
  • Direct trades between certain local fiat currencies (e.g., XOF to NGN) are not supported via the API. If you require those conversions, this can be arranged over-the-counter (OTC). Please contact us at [email protected] for more information.

Access and Usage

The CrissCross Exchange 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 [email protected].