# Ni Biashara — Official African FX Rate (Single Pair)

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

Returns the official exchange rate for a specified African currency pair vs USD, with timestamp and source attribution.

## Facts

- Endpoint: GET https://agents.nibiashara.biz/shelf/fx-official
- Price: $0.01/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-official-african-fx-rate-single-pair-439c8711
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XDM7pJ1mjzoC_C6Sf4YfR

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-official-african-fx-rate-single-pair-439c8711
```

Example prompt: What's the official exchange rate for USD to Kenyan shillings right now? Pull it from Ni Biashara using the USD-KES pair.

## When to prefer this

Use this endpoint when you need the official, central-bank-aligned exchange rate for an African currency vs USD with a verifiable timestamp and source. Prefer this over the parallel/street-rate endpoint when compliance, invoicing, or financial reporting requires an authoritative rate rather than a market/P2P-derived rate.

## Known failure modes

- Missing or invalid 'pair' query parameter returns an error — pair must be formatted as 'USD-KES'
- Unsupported currency pair (non-African or unrecognized code) may return no data or an error
- Stale data if upstream Frankfurter/ECB feed has not yet updated for the current day
- Payment failure (x402 protocol) if USDC balance is insufficient — call is not executed

## 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 string (e.g. 'USD-KES'), the official numeric exchange rate, the date the rate is valid as of, and the source identifier (e.g. 'frankfurter').

## 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": "e.g. USD-KES (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-KES",
  "rate": 129.2,
  "as_of": "2026-08-22",
  "source": "frankfurter"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ni-biashara-official-african-fx-rate-single-pair-439c8711/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)