Path parameters

• bank string Required

  Source code from /api/v1/central-banks (e.g. ecb, boc, cbsl, banxico, ustreasury)

  Format should match the following pattern: ^[a-z0-9_-]{2,20}$.

• date string(date) Required

  Requested date (YYYY-MM-DD)

Query parameters

• source string

  Pair mode: source currency, 3-letter code (requires target)

  Minimum length is 3, maximum length is 3.

• target string

  Pair mode: target currency, 3-letter code (requires source)

  Minimum length is 3, maximum length is 3.

• type string

  Rate type to return when the pair is requested with source+target on a two-sided table (buy/sell banks such as TCMB, BCB, BI, CBN). Values are the bank's own type labels as shown in its full table, e.g. buy or sell. Without it the pair resolves reference, mid, import, buy, sell in that order and rate_type says which side was used. A type the bank does not publish returns 404 listing the available types.

Responses

• 200 application/json

  Table (or single pair) in force on the date

  One of:

  CbTableDated object CbPairDated object

  Hide attributes Show attributes

  • bank string Required
  • name string
  • rate_date string(date) Required
  • rates array[object] Required
    Hide rates attributes Show rates attributes object

    • base string
    • quote string
    • type string

      Rate type as labeled by the bank (reference, buying, selling, indicative, ...)

    • value number(double)
  • disclaimer string
  • requested_date string(date)
  • published_on_requested_date boolean

    False when the bank did not publish on the requested date and the most recent prior table is returned

  Hide attributes Show attributes

  • bank string Required
  • name string
  • rate_date string(date) Required
  • source string Required
  • target string Required
  • rate number(double) Required
  • rate_type string
  • derived boolean

    True when not directly published by the bank (inverse or cross-computed)

  • method string

    Values are published, inverse, or cross.

  • disclaimer string
  • requested_date string(date)
  • published_on_requested_date boolean
• 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

• 403 application/json

  Historical central-bank data requires a paid plan; /latest is available on all plans

  Hide response attributes Show response attributes object

  • error string
  • upgrade_url string
• 404 application/json

  Unknown bank, no data on/before the date, or pair not covered

  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