Quickstart

Create and verify your business

Sign up and complete business verification at app.tradevu.co. Your business must be approved before API access can be enabled, and an admin must turn on isAllowAPIAccess for your account.

Generate an API key

From the Tradevu Dashboard, generate your live API key. Key creation, rotation, and revocation are dashboard-only actions and aren’t exposed through the API — see Authentication for details.

Your API key is shown once. Store it in a secrets manager — never in client-side code or version control. If it leaks, revoke it immediately from the dashboard and generate a new one.

(Optional) Register a webhook URL

Point Tradevu at an endpoint on your server so you’re notified the moment a payment collection settles, instead of polling.

curl -X PUT https://api.tradevu.co/v1/api/set-webhook \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{ "webhookUrl": "https://yourapp.com/webhooks/tradevu" }'

See Webhooks for the payload shape.

Make your first request

Confirm everything is wired up with a quote request — it’s a read-only call, so it’s safe to test with.

curl "https://api.tradevu.co/v1/api/qoutes/USD/NGN/100" \
  -H "x-api-key: <your-api-key>"

Response

{
  "message": "rate fetched Successfully",
  "data": {
    "rate": 1620.5,
    "roundedRate": 1620.5,
    "rateKey": "eyJhbGciOi...",
    "fromCurrency": "USD",
    "toCurrency": "NGN",
    "fee": 1.5,
    "toAmount": 162050,
    "totalAmount": 101.5
  },
  "error": false
}

Collect your first payment

Every collection needs a paymentReference that’s unique on your side — you’ll use it later to look up status.

curl -X POST https://api.tradevu.co/v1/api/deposit \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
        "amount": "100",
        "fromCurrency": "USD",
        "toCurrency": "USD",
        "paymentReference": "order-8271"
      }'

The response includes paymentInstruction — the account details to show your customer. Walk through the full flow, including status polling and webhooks, in Payment Collections.

Next steps

Authentication

Understand API keys, dashboard auth, and required headers.

Payment Collections

Full collection lifecycle: quote, deposit, instructions, status.

Payouts

Send money out — same currency, cross-currency, or to crypto.

API Reference

Every endpoint, parameter, and response field.

Get Started

Guides

Next steps

Authentication

Payment Collections

Payouts

API Reference

​Next steps

Authentication

Payment Collections

Payouts

API Reference

Next steps