# Ni Biashara — African FX Parallel/Street Rate Lookup

> Ni Biashara — African FX Parallel/Street Rate Lookup is a paid API for AI agents from agents.nibiashara.biz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns both the official and parallel/street exchange rate for a given African currency pair (e.g. USD-NGN, USD-GHS), derived from live P2P order books, with spread and confidence data.

## Facts

- Endpoint: GET https://agents.nibiashara.biz/shelf/fx-parallel
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ni-biashara-african-fx-parallel-street-rate-lookup-3c519438
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZzVFEz8GNJYU9TlerZky2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ni-biashara-african-fx-parallel-street-rate-lookup-3c519438
```

Example prompt: What's the current parallel/street rate for USD-NGN — I need the official rate, the P2P mid rate, and the spread between them.

## When to prefer this

Choose this endpoint when you need both the official government/central-bank rate AND the real-world parallel/street rate for West African currencies, especially for remittance pricing, arbitrage analysis, or any context where the official rate diverges significantly from market reality. Prefer over generic FX APIs when the parallel market premium or spread is the key signal needed.

## Known failure modes

- Unsupported currency pair provided (only USD-NGN and USD-GHS are supported) — likely returns a 400 or error payload
- Missing required 'pair' query parameter — returns validation error
- P2P order book has insufficient depth — confidence may be 'low' or data may be stale
- Rate limiting or payment failure via x402 protocol — returns 402 Payment Required
- Service unavailability causing timeout or 5xx error

## How this service works

Structured African-currency FX data (official + parallel/street rates from live P2P order books, with history) and business services (Swahili localization, design, consulting, landing pages), sold per call to AI agents. Ni Biashara LLC, Dallas TX.

## Output

A JSON object containing the currency pair, official rate, parallel mid rate derived from live P2P order books, spread percentage between official and parallel rates, order book depth in USD, and a confidence rating (e.g. medium/high) reflecting data quality.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "pair"
     ],
     "properties": {
      "pair": {
       "type": "string",
       "description": "USD-NGN or USD-GHS (required)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pair": "USD-NGN",
  "depth_usd": 2000,
  "confidence": "medium",
  "spread_pct": 3.26,
  "parallel_mid": 1389.1,
  "official_rate": 1345.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ni-biashara-african-fx-parallel-street-rate-lookup-3c519438/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.nibiashara.biz](https://www.zero.xyz/host/agents.nibiashara.biz/llms.txt)