ShelvesNi Biashara Shelvespay-per-call APIs for AI agents · x402 · USDC on Base
data · instant

Street (parallel-market) rate — USD-NGN or USD-GHS

Parallel/street exchange rate for USD-NGN (naira) or USD-GHS (cedi): the median VWAP of Bybit's public USDT/fiat P2P order book, divided by a USDT/USD spot basis, plus the Frankfurter official reference rate and the spread. OKX is archived and does not set the price. Not a central-bank rate and not a bureau de change quote.

$0.05 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.

Parameters

paramdescription
pairUSD-NGN or USD-GHS (required)

Call it (any x402 client)

# 1. GET without payment → HTTP 402 with PAYMENT-REQUIRED (price, payTo, scheme "exact")
curl -i "https://agents.nibiashara.biz/shelf/fx-parallel?pair=USD-NGN"

# 2. Sign the payment (EIP-3009 transferWithAuthorization, gasless) and retry
#    with the PAYMENT-SIGNATURE header → response body is the delivery.

With the official JS client the whole flow is one wrapped fetch:

import { wrapFetchWithPayment } from "@x402/fetch";       // npm i @x402/fetch @x402/evm
const fetchPaid = wrapFetchWithPayment(fetch, { /* your EVM signer */ });
const res = await fetchPaid("https://agents.nibiashara.biz/shelf/fx-parallel?pair=USD-NGN");
const data = await res.json();

Or install the MCP server (https://agents.nibiashara.biz/mcp, registry id biz.nibiashara/shelves) and use the job-named tool for this shelf, or buy_shelf as an escape hatch.

Calling this repeatedly? Buy a Shelf Pass once ($0.99 for 110 credits) and send X-SHELF-PASS: <token> instead of paying per call — this shelf costs 5 credits per call.

Example response (illustrative shape, not a live rate)

{
  "illustrative": true,
  "note": "Illustrative shape only. Not a live rate and not dated. Call GET /fx/sample/<sku> for a free preview, or pay the shelf for the current quote.",
  "pair": "USD-NGN",
  "official_rate": 1345.2,
  "official_source": "frankfurter.dev",
  "parallel_buy": 1400,
  "parallel_sell": 1378,
  "parallel_mid": 1389,
  "spread_pct": 3.26,
  "depth_usd": 2000,
  "confidence": "medium",
  "sources": [
    "bybit"
  ],
  "pricing_venues": [
    "bybit"
  ],
  "source_name": "Bybit P2P",
  "source_url": "https://www.bybit.com/en/p2p",
  "source_detail": "Median VWAP of the Bybit USDT/fiat P2P book, divided by a USDT/USD spot basis. OKX is archived and does not set this rate."
}

Free preview, no payment: /fx/sample/fx-parallel. Where the number comes from: /fx/methodology.

Delivers

JSON { pair, official_rate, parallel_mid, spread_pct, depth_usd, confidence, sources }

← all shelves