About
Currency rate pairs for currency.traccia.top.
Returns all exchange-rate pairs for a requested currency, including
historical rates by date.
License
No license specified.
Contact information
Base URL
Resources
getCurrency
- GET /api/currency/{currency_name}
- Operation ID: getCurrency
Get currency pairs (latest or for a specific date)
Return all pairs for the requested currency.
* Without a `date` parameter the most recent available snapshot is returned.
* With a `date` parameter an historical snapshot for that date is returned.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| currency_name | path | string | Yes | 3-letter ISO 4217 currency code (case-insensitive), e.g. `USD`, `EUR`, `GBP`. |
| date | query | string | No | Request rates for a specific date. Uses `YYYY-MM-DD` format and must be a day that has data available. |
Response 200
Rate pair snapshot for the requested currency.
{"$ref":"#\/definitions\/CurrencyPairResponse"}
Response 400
Invalid currency name or date format.
{"$ref":"#\/definitions\/Error"}
Response 401
Default response.
{"$ref":"#\/definitions\/DefaultResponse"}
Response 404
Unknown currency, or no data available for the requested currency
and date. Includes `available_dates` for history misses.
{"$ref":"#\/definitions\/Error"}
Response 500
Internal server error.
{"$ref":"#\/definitions\/Error"}
Response 501
Default response.
{"$ref":"#\/definitions\/DefaultResponse"}
Invalid currency name or date format.
{"$ref":"#\/definitions\/Error"}
Response 401
Default response.
{"$ref":"#\/definitions\/DefaultResponse"}
Response 404
Unknown currency, or no data available for the requested currency
and date. Includes `available_dates` for history misses.
{"$ref":"#\/definitions\/Error"}
Response 500
Internal server error.
{"$ref":"#\/definitions\/Error"}
Response 501
Default response.
{"$ref":"#\/definitions\/DefaultResponse"}
Unknown currency, or no data available for the requested currency
and date. Includes `available_dates` for history misses.
{"$ref":"#\/definitions\/Error"}
Response 500
Internal server error.
{"$ref":"#\/definitions\/Error"}
Response 501
Default response.
{"$ref":"#\/definitions\/DefaultResponse"}
Default response.
{"$ref":"#\/definitions\/DefaultResponse"}
Parameters
Definitions
CurrencyPair
{"properties":{"pair":{"description":"Pair identifier in `BASE\/TARGET` form.","example":"USD\/EUR","type":"string"},"rate":{"description":"Units of target currency per unit of base currency.","example":0.913867,"format":"double","type":"number"}},"required":["pair","rate"],"type":"object"}
CurrencyPairResponse
{"properties":{"currency":{"description":"Requested base currency (uppercased).","example":"USD","type":"string"},"date":{"description":"Date the snapshot applies to (`YYYY-MM-DD`).","example":"2026-08-25","format":"date","type":"string"},"pairs":{"description":"Explicit list of pairs with their rates.","items":{"$ref":"#\/definitions\/CurrencyPair"},"type":"array"},"rates":{"additionalProperties":{"format":"double","type":"number"},"description":"Mapping of target currency code to exchange rate.","example":{"EUR":0.913867,"GBP":0.795267},"type":"object"}},"required":["currency","date","rates","pairs"],"type":"object"}
DefaultResponse
{"properties":{"errors":{"items":{"properties":{"message":{"type":"string"},"path":{"type":"string"}},"required":["message"],"type":"object"},"type":"array"}},"required":["errors"],"type":"object"}
Error
{"properties":{"available_dates":{"description":"Dates that have data for the requested currency (only on history\nmisses).\n","items":{"format":"date","type":"string"},"type":"array"},"currency":{"description":"The requested currency, when relevant.","type":"string"},"date":{"description":"The requested date, when relevant.","format":"date","type":"string"},"error":{"description":"Human-readable error message.","type":"string"}},"required":["error"],"type":"object"}