Tools API
Every KeyBS Pay calculator, as an API. Public endpoints need no key (60 requests/minute per IP); higher-value endpoints use a free API key. Versioned from day one — all paths live under /api/v1/tools.
Public endpoints — no key required
Rate limited to 60 requests/minute per IP. Responses include X-RateLimit-* and attribution headers. Please link to keybs.io/tools where output is published.
/api/v1/tools/fxIndicative FX quote with bank comparison
?from=USD&to=GHS&amount=25000/api/v1/tools/settlementSettlement legs (funding + payout rails) for a route
?from=GH&to=CN/api/v1/tools/escrowEscrow structure and indicative fee
?value=50000&deposit_pct=30/api/v1/tools/routesRanked payment rails to a destination
?dest=CN&priority=speed/api/v1/tools/payment-planDated deposit-to-delivery schedule
?value=40000&deposit_pct=30&lead_weeks=4&ship_weeks=6Free API key endpoints
Business-value endpoints need a free key sent in the X-API-Key header. Register below — the key is issued instantly.
/api/v1/tools/quote/live X-API-KeyReference quote with trackable quote ID
?from=USD&to=NGN&amount=10000/api/v1/tools/corridor-pricing X-API-KeyCorridor metadata: volumes, settlement, fee floors, live rates
?corridor=ghana-china/api/v1/tools/supplier-risk X-API-KeySupplier risk band from 5 due-diligence signals
{"registry":"yes","account":"yes",...}Get your free API key
Instant issue, no card, no approval queue. One key per email — registering again returns your existing key.
Example requests
curl "https://keybs.io/api/v1/tools/fx?from=USD&to=GHS&amount=25000" # Key-required endpoint: curl -H "X-API-Key: kbs_free_..." \ "https://keybs.io/api/v1/tools/corridor-pricing?corridor=ghana-china"
Swagger UI
Interactive reference — try every endpoint live.
OpenAPI 3.1 spec
Machine-readable spec for codegen and Postman.
Prefer no code?
Embed the calculators as iframes from the Partner Center.
All Tools API output is indicative and for planning/editorial use — not an executable quote or financial advice. Executable pricing requires a KeyBS Pay quote after KYB, subject to route availability and compliance approval.