Orbita API

Orbita API reference

The Orbita API gives your systems direct access to Bluebulb's treasury platform: check live exchange rates, convert between your currency balances, and pay out to bank accounts at home and abroad.

Production URL

https://api.bluebulb.co.uk

Sandbox URL

https://staging-api.bluebulb.co.uk

Authentication

API key + RSA request signature

Format

JSON over HTTPS

Environments

Build and test against Sandbox (https://staging-api.bluebulb.co.uk), then switch to Production (https://api.bluebulb.co.uk). Code samples in these docs use {baseUrl} — replace it with the URL of the environment you're calling.

What you can do

Rates

Live buy and sell rates for every pair Orbita offers, or one pair at a time.

GETGET

Quotes

Special rates approved for your business, ready to convert at.

GET

Conversions

Move funds between your currency balances.

POSTGETGET

Banks

The banks you can pay out to, with the bank code each payout needs.

GET

Payouts

Pay bank accounts in Nigeria and abroad — in the same currency or converted in the same call — and requery any payout.

POSTGETGET

Sub-wallets

Give each of your customers their own NGN account number to pay you into.

POSTGETGETGETPOSTPOSTPOST

Payments received

See every payment into your sub-wallets, and re-send its webhook.

GETGETPOST

Utilities

Orbita's public key for verifying responses.

GET

Before your first request

1
Complete onboarding and KYC
Your business must be onboarded and verified on Orbita. Conversions and payouts are rejected for unverified businesses.
2
Generate an API key
Your business's Primary Admin generates it from the Orbita dashboard (Settings → API Keys). It is shown once — store it securely. See Authentication.
3
Upload a signing key
Create an RSA key pair, upload the public key from Settings → API Keys → Signing key, and wait for Bluebulb to approve it. See Request signing.
4
Get your IP addresses allowlisted
Send the public IP addresses of the servers that will call the API to your Bluebulb contact. Requests from any other address are rejected. See IP allowlist.
5
Make your first request
Fetch the current rates with List rates, as below.

Your first request

read TS SIG < <(orbita_sign GET '/api/rates' "")

curl "$ORBITA_BASE_URL/api/rates" \
  -H "x-api-key: $ORBITA_API_KEY" \
  -H "X-Signature: $SIG" \
  -H "X-Signature-Timestamp: $TS"

Conventions

Currency codes are lowercase in requests and responses:

ngnusdgbpeurcnyaedcadrndrmbkes

Which pairs you can actually convert or pay out depends on the rates Orbita currently offers — see List rates.

Amounts are decimal numbers in major units: ₦250,000.50 is 250000.50, not kobo.

Dates are ISO 8601 strings in West Africa Time, e.g. 2026-09-22T14:33:10.512+01:00.

IDs for conversions and payouts are UUIDs. Payouts can also be looked up by your own customerReference.