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 in Naira or the US Dollar equivalent.

Pay in Naira or US Dollars — whichever is easier for you.

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. Email [email protected] with your company name and the plan you want (monthly, 6-month, or yearly).
2. We'll reply with payment details in Naira or US Dollars.
3. Once payment is confirmed, we issue your API key and you're live in minutes.

Frequently Asked Questions