Black Market Rates API

Live Nigerian parallel-market exchange rates, delivered as clean JSON.

The Aboki Forex API gives developers and businesses programmatic access to the same live black market (parallel market) exchange rates that power abokiforex.app and our mobile apps. Get the buy and sell rate of the Naira against the US Dollar, Pound, Euro and other major currencies — updated every hour, no scraping required.

What the API Covers

Black market buy/sell rates for the Naira (NGN) against:

Endpoints

The base URL is:

https://abokiforexpaid.uc.r.appspot.com/_ah/api/forex/v1

Authenticate with your key via the X-API-Key header or an ?apiKey= query parameter.

Get all rates

GET /rates

Get a single currency

GET /rates/{currency}   e.g. /rates/USD

Check your usage & quota

GET /usage

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://abokiforexpaid.uc.r.appspot.com/_ah/api/forex/v1/rates"

Example Response

{
  "timestamp": "2026-06-29T09:00:00.000Z",
  "baseCurrency": "NGN",
  "rateType": "black_market",
  "source": "abokiforex.app",
  "rates": {
    "USD": { "buy": 1545.0, "sell": 1555.0 },
    "GBP": { "buy": 1960.0, "sell": 1975.0 },
    "EUR": { "buy": 1670.0, "sell": 1685.0 }
  }
}

buy is the rate at which dealers buy the foreign currency from you; sell is the rate at which they sell it to you. All rates are in Naira (NGN).

Pricing

Every plan includes the full API — all currencies, hourly updates, and 100 API requests per day. Pay online with Paystack and get your API key instantly.

Payments are processed securely by Paystack — card, bank transfer, or USSD. Prefer an invoice or to pay in US Dollars? Email [email protected].

Rate Limits

• Every plan includes 100 requests per day per API key.
• Quotas reset at 00:00 UTC. Check remaining quota any time via /usage.
• Exceeding the quota returns HTTP 429 with a retry hint.
• Rates update hourly — caching responses for a few minutes on your side is recommended.

How to Subscribe

1. Pick a plan above and click Subscribe.
2. Enter your email and company name, then pay securely with Paystack (card, bank transfer, or USSD).
3. Your API key is generated instantly — shown on screen and emailed to you. You're live in minutes.

Need an invoice, a custom quota, or to pay in US Dollars? Email [email protected] and we'll set you up manually.

Frequently Asked Questions