Foreign Exchange
Daily ECB euro reference rates and EUR-triangulated conversions.
Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.
GET/v1/fx/convert
Conversion
Informational ECB conversion, not a transaction or execution price.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| amount | number | string | Yes | — | — | Exact decimal amount to convert |
| from_currency | string | Yes | — | — | ISO 4217 source currency |
| to_currency | string | Yes | — | — | ISO 4217 destination currency |
| date | string (date) | null | No | — | — | Requested fixing date; weekends/holidays resolve to the prior fixing |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/fx/convert?amount=1&from_currency=FROM_CURRENCY&to_currency=TO_CURRENCY"Response
200 Successful Response · expand a branch to see its fields.
dataFxConversionDatarequired
- amountstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- from_currencystringrequired
- to_currencystringrequired
- requested_datestring (date)requirednullable
- rate_datestring (date)required
- ratestringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- convertedstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- derivedbooleanrequired
- unitstringrequired
- currencystringrequired
- as_ofstring (date-time)required
metaFxMetarequired
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- attributionstringrequired
- derived_methodstringrequirednullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/fx/rates
Rates
ECB informational reference rates; not transaction or execution prices.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| quote | string | Yes | — | — | ISO 4217 quote currency, e.g. USD |
| base | string | No | "EUR" | — | ISO 4217 base currency, default EUR |
| start | string (date) | null | No | — | — | Inclusive first fixing date |
| end | string (date) | null | No | — | — | Inclusive last fixing date |
| limit | integer | No | 100 | min 1, max 500 | Rates to return, newest first |
| cursor | string | null | No | — | — | Opaque next_cursor from the previous response |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/fx/rates?quote=QUOTE"Response
200 Successful Response · expand a branch to see its fields.
dataFxRatesDatarequired
- basestringrequired
- quotestringrequired
- unitstringrequired
- currencystringrequired
ratesarray<FxRate>required
- datestring (date)required
- valuestringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- as_ofstring (date-time)required
- derivedbooleanrequired
metaFxMetarequired
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- attributionstringrequired
- derived_methodstringrequirednullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable