Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Interest Rates (Historical)

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data Operations

Interest Rates (Historical)

​

One central bank's policy rate over time, as an interest_rates array of bank, name, date and rate. bank is required and bound by start_date and end_date. Trap worth knowing: the code is case-sensitive and must be uppercase — FED works, fed returns HTTP 404 with "No data found", which reads like an empty result rather than a bad argument. Valid codes are FED, ECB, BOJ, BOE, BOC, RBA, PBOC, SNB, RBI and BOK; get_financial_macro_interest_rates_snapshot with no arguments lists them all.

Query Parameters
  • bank
    Type: string enum
    required

    The bank whose interest rates to return. Use the /macro/interest-rates/banks endpoint to get a list of available banks. Case-sensitive: must be uppercase. A lowercase code returns HTTP 404 "No data found", which reads like an empty result rather than a bad argument.

    values
    • FED
    • ECB
    • BOJ
    • BOE
    • BOC
  • start_date
    Type: string

    The start date of the interest rates to return in YYYY-MM-DD format.

  • end_date
    Type: string

    The end date of the interest rates to return in YYYY-MM-DD format.

Responses
  • 200
    Type: object · InterestRatesResponse

    Interest rates response

    • interest_rates
      Type: array object[] · InterestRate[]
      • bank
        Type: string

        The symbol of the central bank.

      • date
        Type: string

        The date of the interest rate in YYYY-MM-DD format.

      • name
        Type: string

        The name of the central bank.

      • rate
        Type: number

        The interest rate of the central bank.

    application/json
  • 400
    Type: object · ErrorResponse

    Bad request

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 401
    Type: object · ErrorResponse

    Unauthorized

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 402
    Type: object · ErrorResponse

    The request requires a paid subscription

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 403

    The account is not permitted to perform this operation.

  • 404
    Type: object · ErrorResponse

    The specified resource was not found

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/financial/macro/interest-rates
curl 'https://openapi.felo.ai/v1/beta/financial/macro/interest-rates?bank=FED' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "interest_rates": [
    {
      "bank": "string",
      "name": "string",
      "rate": 1,
      "date": "string"
    }
  ]
}

Interest rates response

Interest Rates (Historical)