Iliria98 API
Access real-time and historical exchange rate data
https://api.iliria98.comRESTful API
Simple, predictable endpoints following REST conventions with JSON responses
Secure
API key authentication via Bearer token with HTTPS encryption on all requests
Rate Limited
Fair usage limits with clear response headers to track your quota in real-time
Authentication
All API requests require a valid API key
Include your API key in the Authorization header as a Bearer token. You can obtain an API key by contacting our team.
// Include this header in every request Authorization: Bearer il98_live_a1b2c3d4e5f6g7h8i9j0
Keep your API key secure. Never expose it in client-side code or public repositories. Use environment variables and server-side requests only.
Rate Limiting
Fair usage policies to ensure service reliability
Rate Limit Response Headers
X-RateLimit-Limit: 60 // Max requests per minute for your plan X-RateLimit-Remaining: 45 // Requests remaining in current window X-RateLimit-Reset: 1741334460 // Unix timestamp when the window resets
When you exceed the rate limit, the API returns a 429 Too Many Requests status. Wait until the reset time before retrying. Pro and Enterprise plans include burst allowances.
Endpoints
3 core endpoints for exchange rate data, currency conversion, and historical trends
Parameters
baseBase currency code (e.g. ALL, EUR, USD)
ALLsymbolsComma-separated currency codes to filter (e.g. EUR,USD,GBP)
Request
curl -X GET \ "https://api.iliria98.com/api/v1/rates?base=ALL&symbols=EUR,USD,GBP" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Response
{
"success": true,
"base": "ALL",
"timestamp": 1741334400,
"date": "2026-03-07",
"rates": {
"EUR": {
"buy": 100.50,
"sell": 101.20
},
"USD": {
"buy": 93.40,
"sell": 94.10
},
"GBP": {
"buy": 118.30,
"sell": 119.50
}
}
}Parameters
fromSource currency code (e.g. ALL)
toTarget currency code (e.g. EUR)
amountAmount to convert
Request
curl -X GET \ "https://api.iliria98.com/api/v1/convert?from=ALL&to=EUR&amount=10000" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Response
{
"success": true,
"from": "ALL",
"to": "EUR",
"amount": 10000,
"result": 98.81,
"rate": 0.009881,
"timestamp": 1741334400
}Parameters
baseBase currency code
ALLsymbolTarget currency code (e.g. EUR)
periodTime period: 1D, 1W, 1M, 3M, 6M, or 1Y
1MRequest
curl -X GET \ "https://api.iliria98.com/api/v1/history?base=ALL&symbol=EUR&period=1M" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Response
{
"success": true,
"base": "ALL",
"symbol": "EUR",
"period": "1M",
"data": [
{
"date": "2026-02-05",
"buy": 99.80,
"sell": 100.45
},
{
"date": "2026-02-06",
"buy": 100.10,
"sell": 100.78
}
]
}Ready to get started?
Request your API key today and start integrating live exchange rates into your application.
