{"name":"AI Money — Africa FX","store":"Ni Biashara Shelves","provider":"Ni Biashara LLC","description":"Structured African-currency FX data for AI agents: official exchange rates, timestamped and sourced, priced per call over the x402 protocol.","x402":{"version":2,"supported_versions":[1,2],"current":"GET /shelf/:sku speaks x402 v2: PAYMENT-REQUIRED header, PAYMENT-SIGNATURE, CAIP-2 network eip155:8453.","legacy":"GET /api/fx, /api/fx/:pair and /api/parallel/:pair still return an x402 v1 JSON body (x402Version 1, network name from env) and also a v2 PAYMENT-REQUIRED header. Both PAYMENT-SIGNATURE and X-PAYMENT are accepted on those routes.","route_versions":{"/api/fx":1,"/api/fx/:pair":1,"/api/parallel/:pair":1,"/shelf/:sku":2,"/checkout/:sku":2},"scheme":"exact","network":"base","facilitator_url":"https://api.cdp.coinbase.com/platform/v2/x402","asset":"USDC","discoverable":true},"pay_to":"0x403b72e2EdbC9dB738e09D3064a6A54f8A027055","endpoints":[{"method":"GET","path":"/","price_usd":0,"description":"This service description."},{"method":"GET","path":"/healthz","price_usd":0,"description":"Liveness check."},{"method":"GET","path":"/shelf/:sku","price_usd":null,"price_source":"/catalog","description":"Every shelf as a one-call x402 v2 resource (scheme exact, USDC on Base, CDP facilitator). GET → 402 + PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE → delivery. Prices per shelf in /catalog."},{"method":"GET","path":"/checkout/:sku","price_usd":null,"price_source":"/catalog","description":"Same shelves via a Coinbase Business checkout (auth-capture x402 v2 for agents, hosted page for humans)."},{"method":"POST","path":"/mcp","price_usd":0,"description":"MCP server (streamable HTTP): list_shelves, buy_shelf, get_order, get_pass_balance, check_carrier_authority, check_carrier_basics, check_broker_authority, vet_load, screen_sanctions_name, screen_sanctions_wallet, get_diaspora_metro_snapshot, get_fx_official, get_fx_parallel, get_fx_africa_brief, localize_text, check_tx_insurance_ce, check_tx_realestate_ce, buy_shelf_pass, estimate_us_nigeria_shipping, prepare_us_nigeria_shipment_handoff, check_diaspora_business_listing. Descriptor at GET /mcp.json."},{"method":"GET","path":"/api","price_usd":null,"price_source":"/catalog","description":"The API root is a real x402 resource: the same paid call as /shelf/fx-official-all. Also at /api/v1."},{"method":"GET","path":"/auth.md","price_usd":0,"description":"How agents get access: free discovery, x402 per call, Shelf Pass, and an optional agent identity (OAuth) that can spend a linked Shelf Pass."},{"method":"POST","path":"/agent/identity","price_usd":0,"description":"Register an anonymous agent identity: {\"type\":\"anonymous\"} returns an identity_assertion. See /auth.md."},{"method":"POST","path":"/oauth2/token","price_usd":0,"description":"Exchange the assertion (jwt-bearer) or a refresh token for an access token."},{"method":"POST","path":"/oauth2/revoke","price_usd":0,"description":"RFC 7009 token revocation."},{"method":"GET","path":"/agent/me","price_usd":0,"description":"Who this bearer is and its linked Shelf Pass credit total."},{"method":"POST","path":"/agent/pass/link","price_usd":0,"description":"Pin a Shelf Pass you bought to this identity; the bearer then spends it on /shelf and /mcp."},{"method":"GET","path":"/.well-known/x402","price_usd":0,"description":"IETF x402 DNS-discovery manifest: priced data resources, kind resource-server."},{"method":"GET","path":"/docs","price_usd":0,"description":"Human/LLM-readable documentation for every shelf, with copy-pasteable x402 calls."},{"method":"GET","path":"/pass","price_usd":0,"description":"Shelf Pass balance: send the X-SHELF-PASS header (never the token in a URL). Buy a pass at /shelf/shelf-pass-100 ($0.99, 110 credits on data shelves ≤$0.25); redeem with the X-SHELF-PASS header."},{"method":"POST","path":"/pass/unlink","price_usd":0,"description":"Detach your Shelf Pass from any agent identity it is linked to (X-SHELF-PASS header). Credits stay on the pass."},{"method":"POST","path":"/a2a","price_usd":0,"description":"Google A2A JSON-RPC endpoint with the a2a-x402 payments extension; Agent Card at /.well-known/agent-card.json."},{"method":"GET","path":"/catalog","price_usd":0,"description":"Every shelf Ni Biashara sells to agents (data + services) with prices, params and a buy route. Settles through Coinbase Business checkouts: POST /buy/:sku returns an x402_url to pay."},{"method":"GET","path":"/api/fx","price_usd":0.02,"description":"All supported pairs vs USD in one call."}],"supported_pairs":["USD-KES","USD-NGN","USD-GHS","USD-TZS","USD-UGX","USD-ZAR","USD-EGP","USD-RWF"],"parallel_pairs":["USD-NGN","USD-GHS"],"fx_prices_usd":{"shelves":{"fx-official":0.01,"fx-official-all":0.02,"fx-parallel":0.05,"fx-parallel-history-24h":0.1,"fx-parallel-history-7d":0.25,"fx-africa-daily-brief":0.1},"legacy_api":{"/api/fx/:pair":0.01,"/api/fx":0.02,"/api/parallel/:pair":0.01},"note":"/api/parallel/:pair charges $0.01 because that is the amount in its 402. /shelf/fx-parallel charges the catalog price. Do not mix them."},"no_parallel_market":{"KES":"no material parallel market; the shilling floats and the official rate is the market rate","EGP":"the pound was unified in 2024; the residual premium is below the P2P rail's own cost","UGX":"no material parallel market; official rate is the market rate","TZS":"no material parallel market; official rate is the market rate","ZAR":"no exchange controls of this kind; any premium observed is P2P rail cost, not a street rate","RWF":"no material parallel market; official rate is the market rate"}}