# AgentStall ZA Exchange Rates (African Currencies)

> AgentStall ZA Exchange Rates (African Currencies) is a paid API for AI agents from agentstall.nilesh-b54.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-02).

Returns daily mid-market exchange rates for African and major currencies against a chosen base currency, with optional amount conversion.

## Facts

- Endpoint: GET https://agentstall.nilesh-b54.workers.dev/v1/exchange-rates?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstall-za-exchange-rates-african-currencies-3f3bfc80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZA2SAKapnGoUdm7Y9yMYu

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 agentstall-za-exchange-rates-african-currencies-3f3bfc80
```

Example prompt: What's today's exchange rate from USD to South African rand, Nigerian naira, and Kenyan shilling — and how much would 2500 USD be in rand?

## When to prefer this

Choose this endpoint when you need daily mid-market African currency exchange rates — especially ZAR, NGN, KES, EGP, GHS, MAD, and CFA francs — for pricing, invoicing, or reporting purposes. It is ideal for agents operating in African markets that need a quick, affordable snapshot rate rather than real-time trading data. Prefer alternatives if you need official central-bank fixings, tick-level precision, or live streaming rates.

## Known failure modes

- Invalid or unsupported currency code returns an error or empty rates
- Dataset may lag by up to one business day — not real-time tick data
- No historical date support — always returns the latest available daily rate
- Payment failure (402) if USDC balance is insufficient
- Rate unavailable for exotic or unofficial currency codes

## How this service works

Daily exchange rates with African currencies by default: South African rand (ZAR), Nigerian naira (NGN), Kenyan shilling (KES), Egyptian pound (EGP), Ghanaian cedi (GHS), Moroccan dirham, CFA francs and more, against USD, EUR or any base currency, with optional amount conversion. Reference mid-market rates from an open daily dataset, not official central-bank fixings. Useful for pricing, invoices, quotes and reports.

## Output

Returns a JSON object with the base currency, today's date, and a rates map of currency codes to their mid-market exchange rates against the base. If an amount is provided, also returns a converted object showing the converted values in each requested currency.

## 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": [],
     "properties": {
      "base": {
       "type": "string",
       "description": "Base currency code (default USD)"
      },
      "amount": {
       "type": "string",
       "description": "Optional amount in the base currency to convert"
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated currency codes to return (default: 18 African currencies plus USD, EUR, GBP, CNY)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "date": "2026-10-31",
  "rates": {
   "EGP": 55.88,
   "KES": 129.85,
   "NGN": 1346.55,
   "ZAR": 16.7089
  },
  "converted": {
   "ZAR": 1670.89
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstall-za-exchange-rates-african-currencies-3f3bfc80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstall.nilesh-b54.workers.dev](https://www.zero.xyz/host/agentstall.nilesh-b54.workers.dev/llms.txt)