exchangerate-dev Currencies API

openapi: 3.2.0
info:
  title: exchangerate.dev Currencies API
  description: 'Live indicative foreign-exchange rates for developers. Explicit `source` and `market_session` labels on every response — live intraday (~60s) on trading days for all currencies, with ECB daily fallback in the 144-currency catalog (10296 unique pairs). Free tier: 5,000 calls/month, no card. Live rates 15 minutes delayed. MCP server: https://api.exchangerate.dev/v1/mcp/ · Docs: https://exchangerate.dev/docs'
  contact:
    url: https://exchangerate.dev/docs
  version: '1.0'
tags:
- name: Currencies
paths:
  /v1/currencies:
    get:
      summary: Currencies
      description: 'Supported currencies. BGN is fixed to the euro (1.95583 BGN per EUR, see `fixed_to_euro`): its rates follow the euro and are not a live market rate.'
      operationId: currencies_v1_currencies_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CurrenciesResponse'
        '400':
          description: Bad request. Codes include invalid_pair, unsupported_base, bad_date, invalid_amount, invalid_request, missing_parameter, unsupported_interval, unsupported_pair_interval and unsupported_index_interval.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 'Authentication failed: invalid_api_key (or invalid_session_token on dashboard routes).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: 'plan_gated: the caller''s plan does not include this interval or history depth; forbidden: the request did not pass through the public origin.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found, e.g. unknown_index or no_data_for_date.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Request validation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: 'Rate limit or quota exceeded: rate_limited (per-minute limit, X-RateLimit-Scope tier-rate-minute), ip_rate_limited (keyless per-IP hourly cap, anon-ip-hour) or quota_exceeded (monthly quota, tier-quota-month). Wait Retry-After seconds; do not retry a monthly quota error automatically. quota_unavailable means the quota store could not be read; retry after Retry-After.'
          headers:
            X-RateLimit-Limit:
              description: Limit for the window named by X-RateLimit-Scope.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in that window (0 on a 429).
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Unix time (seconds) when the window resets.
              schema:
                type: integer
            X-RateLimit-Scope:
              description: 'Which limit applied: anon-ip-hour, tier-rate-minute or tier-quota-month.'
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: The operation failed internally.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: A required data source or feature is temporarily unavailable, e.g. data_unavailable, live_unavailable, source_unavailable or service_unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Currencies
components:
  schemas:
    CurrenciesResponse:
      properties:
        result:
          type: string
          title: Result
          default: success
        currencies:
          items:
            $ref: '#/components/schemas/CurrencyInfo'
          type: array
          title: Currencies
      type: object
      required:
      - currencies
      title: CurrenciesResponse
    ErrorResponse:
      properties:
        result:
          type: string
          title: Result
          default: error
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      type: object
      required:
      - code
      - message
      title: ErrorResponse
    CurrencyInfo:
      properties:
        code:
          type: string
          title: Code
        name:
          type: string
          title: Name
        type:
          type: string
          title: Type
          default: fiat
        decimals:
          type: integer
          title: Decimals
        minor_units:
          type: integer
          title: Minor Units
        is_derived:
          type: boolean
          title: Is Derived
        fixed_to_euro:
          anyOf:
          - type: number
          - type: 'null'
          title: Fixed To Euro
          description: 'Set only for a currency fixed to the euro (e.g. BGN): its legal units per 1 EUR. Its rates follow the euro at this fixed rate; they are not an independent market rate. Null for every other currency.'
      type: object
      required:
      - code
      - name
      - decimals
      - minor_units
      - is_derived
      title: CurrencyInfo