ProductsCrypto RailsAvailable at launch
Let your users buy and sell crypto with naira.
One API for a quote your user has seen and an order placed against it — paid for trade by trade, with nothing for you to pre-fund, and an honest answer when a rail does not give one.


How it works
Quote. Order. Read the outcome.
Step 1: Ask for a quote
Say what your user wants to buy or sell. You get the rate, our fee, your commission and the moment the quote expires — the figures hold until then.
Step 2: Place the order
Turn the quote into an order for a person you have checked with a BVN identity check, with an Idempotency-Key. The order tells you how your user pays: a bank account to buy, a crypto deposit address to sell.
Step 3: Read the outcome
Your user pays for that one trade. We convert and deliver — naira to their bank, or crypto to their wallet — and look the order up by its reference at any time for where it stands.
The calls
A sell, in two calls from the published contract.
curl https://api.vertexbridge.io/v1/partner/crypto/sell/quotes \ -H "X-API-Key: $VERTEXBRIDGE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "asset": "USDT", "network": "'"$NETWORK"'", "asset_amount_minor": "100000000" }'curl https://api.vertexbridge.io/v1/partner/crypto/sell/orders \ -H "X-API-Key: $VERTEXBRIDGE_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "quote_id": "'"$QUOTE_ID"'", "customer_reference": "user_8812", "payout_account": { "bank_code": "'"$BANK_CODE"'", "account_number": "'"$ACCOUNT_NUMBER"'", "account_name": "'"$ACCOUNT_NAME"'" } }'Launching with USDT. Amounts are integers in the smallest unit — kobo for naira, and six decimals for USDT, so 100000000 is 100 USDT. A buy is the same two calls on /buy/. Send crypto only on the network the order states, and use a new Idempotency-Key for each order.
Irreversible by nature
Built for a trade that cannot come back
A crypto transfer cannot be recalled. These are the properties that matter.
Quoted, then honoured
An order is placed against a quote your user has seen, never against what the market did since. A quote past its expiry cannot become an order.
Nothing to pre-fund
Your user pays for each trade directly, so none of your balance is tied up in a float. Any commission you set is credited to your balance when the order completes.
Checked before it moves
Crypto cannot be reversed, so every order needs a person you have first checked with a BVN identity check.
Indeterminate, not a guess
If we cannot yet tell how a trade ended — including a payment that arrived after the quote expired — the order is indeterminate, never failed. Do not refund your user; we resolve it.
Every field and state is in the API reference. How retries work is in Idempotency, and what an unclear answer means in Indeterminate. The check every order needs first is Identity.


Add crypto to your platform.
Crypto Rails is enabled per account. Tell us your volumes and we will set up your account and agree your rates.