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).

Plans & Rate Limits

• Each key has a daily request quota sized to your plan.
• 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 expected daily request volume.
2. We'll reply with a plan and pricing that fits your usage.
3. Once subscribed, we issue your API key and you're live in minutes.

Frequently Asked Questions