Attest tools · currency_convert
a task needs an indicative conversion of an amount between two of about 30 major currencies (AUD, USD, GBP, JPY, NZD, CAD, CNY and others) at the latest European Central Bank reference rates, for estimates or reports,…
Bearer key · JSON
curl -s -X POST https://getattest.com.au/api/v1/currency/convert \
-H "authorization: Bearer $ATTEST_API_KEY" \
-H "content-type: application/json" \
-d '{}'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 an indicative conversion of an amount between two of about 30 major currencies (AUD, USD, GBP, JPY, NZD, CAD, CNY and others) at the latest European Central Bank reference rates, for 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.
3 fields
Scroll the table horizontally to see all fields.
| Field | Type | Required | What it does |
|---|---|---|---|
amount | number | Required | The amount to convert, as a JSON number. A numeric string is refused rather than guessed at. |
from | string | Required | Three-letter code of the currency the amount is in. |
to | string | Required | Three-letter code to convert to. |
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 |
|---|---|
rate | The rate used, derived from the ECB euro reference rates. |
result | The converted amount, rounded for money. |
result_raw | The unrounded conversion, for callers doing their own rounding. |
rates_date | The date of the ECB rate table used. |
source | The ECB table and its date. |
source_url | The ECB page the rates are published on, free of charge. |
note | That these are indicative reference rates for estimates and reports, 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 |
|---|---|---|
amount_required | 400 | No amount was sent. |
invalid_amount | 400 | amount is not a finite JSON number. |
amount_too_large | 400 | amount is beyond the range this service converts. |
unknown_currency | 400 | from or to is not a currency in the ECB table. |
result_too_large | 400 | The converted amount cannot be returned as a JSON number. |
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