API

currency-rates

Returns current rates against the requested base. Served from a short server-side cache; a `stale` flag marks a fallback to the last good snapshot when the upstream feed is briefly unavailable.

Call it

POST https://timbrica.com/v1/tools/currency-rates/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <your retry-safe key>
Content-Type: application/json

Input

Errors it can return

invalid_base  upstream_unavailable 

History

• v1 — 2026-07-30 — Initial release.

This contract cannot change without a new version and a line above: a test compares the published schema, pricing and limits against a committed lockfile and fails the build otherwise. Subscribe to /v1/changelog to be told when something moves.