# Ni Biashara — African FX Parallel Rate 7-Day History

> Ni Biashara — African FX Parallel Rate 7-Day History is a paid API for AI agents from agents.nibiashara.biz, paid per call via x402, $0.99/call, status unknown (last checked 2026-09-14).

Returns 7 days of historical parallel/street-market mid-rates and spread percentages for a specified African currency pair (USD-NGN or USD-GHS), derived from live P2P order books.

## Facts

- Endpoint: GET https://agents.nibiashara.biz/shelf/fx-parallel-history-7d
- Price: $0.99/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ni-biashara-african-fx-parallel-rate-7-day-history-49818bf8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W3pYDbX3DnRw6gAIkFV3h

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-rate-7-day-history-49818bf8
```

Example prompt: Pull the last 7 days of parallel street-market rate history for USD-NGN, including the daily mid-rates and spread percentages from the P2P order book.

## When to prefer this

Choose this endpoint when you need a time-series view of parallel/street exchange rates for Nigerian naira (NGN) or Ghanaian cedi (GHS) over the past week, particularly when official rates are insufficient and you need P2P order book-derived pricing. Prefer this over the single-rate endpoint when trend analysis, spread tracking, or historical context is required.

## Known failure modes

- Missing or invalid 'pair' query parameter returns an error — only USD-NGN and USD-GHS are supported
- Requesting an unsupported currency pair (e.g. USD-KES) will result in a validation or not-found error
- Payment failure or unpaid x402 request returns HTTP 402 before data is delivered
- Data gaps may exist if P2P order book had insufficient liquidity on a given day
- Network timeout if upstream P2P data source is slow to respond

## 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 label, a 7-day window identifier, and an array of daily data points each with a timestamp, the parallel market mid-rate, and the spread percentage between official and parallel rates.

## 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",
  "points": [
   {
    "spread_pct": 3.4,
    "captured_at": "2026-08-16T00:00:00Z",
    "parallel_mid": 1392.4
   }
  ],
  "window": "7d"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ni-biashara-african-fx-parallel-rate-7-day-history-49818bf8/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)
