Attest tools · currency_rates
a task needs today's European Central Bank reference exchange rates for about 30 major currencies (AUD, USD, GBP, JPY, NZD, CAD, CNY and others) against any of them as base, for information such as estimates or report…
Bearer key · query string
curl -s "https://getattest.com.au/api/v1/currency/rates" \
-H "authorization: Bearer $ATTEST_API_KEY"Send the key as a bearer token in the authorization header. One key and one credit balance cover every service, including Attest Capture. A failed call is refunded automatically. No key yet? POST /api/v1/keys issues one with 25 free credits and no signup — see the key guide.
For agents
Use this when a task needs today's European Central Bank reference exchange rates for about 30 major currencies (AUD, USD, GBP, JPY, NZD, CAD, CNY and others) against any of them as base, for information such as estimates or reports, not for transactions. The ECB publishes the euro rates free of charge on its website.
Not documented yet: a captured example response. This page only shows what the module publishes about itself, so the missing parts are absent rather than guessed at.
1 field
Scroll the table horizontally to see all fields.
| Field | Type | Required | What it does |
|---|---|---|---|
base | string | Optional | Three-letter code to quote the rates against. Defaults to EUR, the currency the ECB publishes. |
HTTP 200
Every successful response also carries call_id (your receipt for the charge), credits_charged and credits_remaining.
Scroll the table horizontally to see all fields.
| Field | What it holds |
|---|---|
base | The base currency the rates are quoted against. |
rates | One rate per currency in the ECB table. |
rates_date | The date of the ECB rate table. |
source | The ECB table and its date. |
source_url | The ECB page the rates are published on, free of charge. |
note | That a non-euro base is derived by cross-rate, and that these are reference rates, not transaction rates. |
Machine-readable failures
Errors return JSON such as {"error":"invalid_api_key"}. A failed call is refunded automatically.
Scroll the table horizontally to see all fields.
| Code | Status | Meaning |
|---|---|---|
unknown_currency | 400 | base is not a currency in the ECB table. |
rates_unavailable | 502 | The ECB rate file could not be read. Not charged. |
Scroll the table horizontally to see all fields.
| Code | Status | Meaning |
|---|---|---|
invalid_api_key | 401 | The authorization header is missing or the key is unknown. |
insufficient_credits | 402 | The balance is below this call's cost. The response carries credits_required and credits_remaining. |
rate_limit_exceeded | 429 | Free keys share 10 calls a minute across every service. The response carries limit and window_seconds. |
services_unavailable | 503 | The credit store could not be reached. Retry once after 30 seconds. |
Where the answer comes from
Euro foreign exchange reference rates published by the European Central Bank, which makes them available free of charge on its website (https://www.ecb.europa.eu).
Attest reports what it read, with the source it read it from. It is general information, not advice, and not a legal record.
Same key as every Attest tool
Issue a free key, then use it here, on Attest Capture and on every other tool in the box.
Get a free key