Frankfurter

Frankfurter metadata API

API reference data like available currencies

Documentation GitHub OpenAPI

Documentation

https://frankfurter.dev/docs

Specifications

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/openapi/frankfurter-metadata-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v2-rate-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v2-currency-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v2-currency-detail-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v2-provider-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v2-rate-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v2-currency-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v2-currency-detail-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v2-provider-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-rates-on-date-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-rates-by-date-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-rates-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-currencies-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-amount-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-base-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-base-in-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-schema/v1-date-schema.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-rates-on-date-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-rates-by-date-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-rates-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-currencies-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-amount-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-base-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-base-in-structure.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-structure/v1-date-structure.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-ld/frankfurter-v2-context.jsonld

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v2-rate-example.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v2-currency-example.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v2-currency-detail-example.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v2-provider-example.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/json-ld/frankfurter-v1-context.jsonld

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v1-rates-on-date-example.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v1-rates-by-date-example.json

https://raw.githubusercontent.com/api-evangelist/frankfurter/refs/heads/main/examples/v1-currencies-example.json

OpenAPI Specification

openapi: 3.1.2
info:
  title: Frankfurter Currencies metadata API
  description: Frankfurter is an open-source API for current and historical foreign exchange rates, sourcing currency data from public providers like the European Central Bank.
  version: 1.0.0
  license:
    name: MIT
    url: https://github.com/lineofflight/frankfurter/blob/main/LICENSE
  contact:
    url: https://github.com/lineofflight/frankfurter/issues
  x-generated-from: upstream
  x-last-validated: '2026-05-29'
servers:
- url: https://api.frankfurter.dev/v1
tags:
- name: metadata
  description: API reference data like available currencies
paths:
  /currencies:
    get:
      tags:
      - metadata
      summary: Frankfurter Get Available Currencies
      description: Returns a list of available currencies with their full names
      responses:
        '200':
          description: List of available currencies
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/currencies'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    currencies:
      type: object
      propertyNames:
        $ref: '#/components/schemas/base'
      additionalProperties:
        type: string
        description: Full name of the currency
        minLength: 1
      minProperties: 1
      example:
        AUD: Australian Dollar
        BGN: Bulgarian Lev
        EUR: Euro
        USD: US Dollar
    base:
      type: string
      enum:
      - AUD
      - BGN
      - BRL
      - CAD
      - CHF
      - CNY
      - CZK
      - DKK
      - EUR
      - GBP
      - HKD
      - HUF
      - IDR
      - ILS
      - INR
      - ISK
      - JPY
      - KRW
      - MXN
      - MYR
      - NOK
      - NZD
      - PHP
      - PLN
      - RON
      - SEK
      - SGD
      - THB
      - TRY
      - USD
      - ZAR
      description: The base currency code following ISO4217