Public exchange rate API for Costa Rica, powered by BCCR
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"ticorates-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# TicoRates 🇨🇷 [](https://github.com/jonach1998/ticorates/actions/workflows/test-and-publish.yml) [](https://pypi.org/project/ticorates-mcp/) [](https://hub.docker.com/r/jonach1998/ticorates) [](https://opensource.org/licenses/MIT) Free, open exchange rate API for Costa Rica — powered by BCCR. No sign-up, no token, ready to use. **Live server → `https://ticorates.dev` — free for everyone, no API key required.** ## How it works 1. **Request** — you call any endpoint with a date and currency code. 2. **Cache check** — if the rate is already in the database, it's returned instantly. 3. **BCCR fetch** — on a cache miss, rates are fetched from Banco Central de Costa Rica in real time. 4. **Store & serve** — the result is cached in SQLite for all future requests to the same date. Historical dates are served from cache after the first request. Concurrent requests for the same date are deduplicated — only one BCCR call is made regardless of how many clients ask simultaneously. ## Try it now No installation. No registration. Paste and run: ```bash # Today's USD rate curl "https://ticorates.dev/rates/latest?currency=USD" # Rate on a specific date curl "https://ticorates.dev/rates?date=2025-01-15¤cy=USD" # Last 30 days curl "https://ticorates.dev/rates?from=2025-04-01&to=2025-04-30¤cy=USD" # All supported currencies curl https://ticorates.dev/currencies ``` Interactive docs → **[ticorates.dev/docs](https://ticorates.dev/docs)** ## Features - **REST API** — simple HTTP endpoints, no authentication required - **43 currencies** — USD, EUR, GBP, JPY, CAD, AUD, CHF, and more - **On-demand caching** — rates are fetched from BCCR on first request and served in…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.