Historical market rates for a currency pair

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/allratestoday/doc/allratestoday-api/mcp

Standard setup for AI tools providing an mcp.json file

{
  " AllRatesToday API MCP server": {
    "url": "https://bump.sh/allratestoday/doc/allratestoday-api/mcp"
  }
}

GET /api/historical-rates

Bearer auth Session cookie

Time series of mid-market rates for one pair over a preset period. 1d returns hourly points; 7d and 30d daily points; 1y weekly-sampled points. Requires an API key (Bearer header) or a logged-in session.

Query parameters

source string Required

Source currency code (ISO 4217)
target string Required

Target currency code (ISO 4217)
period string

Time window

Values are 1d, 7d, 30d, or 1y. Default value is 7d.
format string

Response format (default json). csv is UTF-8 with a BOM; xlsx is a real Excel workbook with typed dates and numbers; xml mirrors the JSON fields.

Values are json, csv, xml, or xlsx. Default value is json.

Responses

200 application/json

Historical series (oldest first)
Hide response attributes Show response attributes object
- source string Required
- target string Required
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  date string
  
  YYYY-MM-DD (ISO date-time for 1d period)
  
  rate number(double)
  
  timestamp integer(int64)
  
  Unix time in milliseconds
- source_api string
- period string Required
  
  Values are 1d, 7d, 30d, or 1y.
400 application/json

Invalid or missing parameters
Hide response attributes Show response attributes object
- error string Required
  
  Error message
- hint string
  
  Optional remediation hint
401 application/json

Authentication required — provide an API key via Authorization: Bearer art_live_... (free keys at https://allratestoday.com/register)
Hide response attributes Show response attributes object
- error string Required
  
  Error message
- hint string
  
  Optional remediation hint
429 application/json

Monthly request limit exceeded (X-Monthly-Limit / X-Monthly-Used / X-Monthly-Resets headers included)
Hide response attributes Show response attributes object
- error string
- used integer
- limit integer
- plan string
- resets_at string(date-time)
- upgrade_url string
500 application/json

Server or upstream error
Hide response attributes Show response attributes object
- error string Required
  
  Error message
- hint string
  
  Optional remediation hint

GET /api/historical-rates

curl \
 --request GET 'https://allratestoday.com/api/historical-rates?source=USD&target=LKR' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "source": "USD",
  "target": "LKR",
  "data": [
    {
      "date": "2026-08-10",
      "rate": 302.4512,
      "timestamp": 42
    }
  ],
  "source_api": "mid-market",
  "period": "1d"
}

Response examples (400)

{
  "error": "string",
  "hint": "string"
}

Response examples (401)

{
  "error": "string",
  "hint": "string"
}

Response examples (429)

{
  "error": "Request limit exceeded",
  "used": 42,
  "limit": 42,
  "plan": "free",
  "resets_at": "2026-05-04T09:42:00Z",
  "upgrade_url": "https://allratestoday.com/pricing"
}

Response examples (500)

{
  "error": "string",
  "hint": "string"
}