Felo API PlatformFelo API Platform
全部 Financial Data 端点
v0.2.0-beta
OpenAPI 3.1.0

利率(历史)

服务器:https://openapi.felo.ai
客户端库

Financial Data

​

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

利率(历史)

​

一家央行的政策利率随时间的变化,以 interest_rates 数组返回,包含 bank、name、date 和 rate。bank 为必填,并受 start_date 和 end_date 限定。值得注意的陷阱:代码区分大小写,且必须为大写——FED 可用,fed 会返回 HTTP 404 和 "No data found",看起来像空结果,而不是参数错误。有效代码为 FED、ECB、BOJ、BOE、BOC、RBA、PBOC、SNB、RBI 和 BOK;不带参数调用 get_financial_macro_interest_rates_snapshot 即可列出全部。

计费参考

  • 计量方式:按成功请求的固定成本计费。
  • 参考请求估算:0.02 美元。
  • 参考客户倍率:1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数
  • bank
    类型: string
    必填

    央行代码,例如 FED、ECB、BOJ。使用 /macro/interest-rates/banks 端点获取可用央行列表。

  • cursor
    类型: string

    来自先前响应 next_page_url 的不透明分页游标。提供后,其他所有查询参数都会被忽略:游标携带原始请求的筛选条件。请将其视为不透明值,不要构造或修改。

  • end_date
    类型: string

    要返回的最后日期(含当日),格式为 YYYY-MM-DD。默认为今天。

  • start_date
    类型: string

    要返回的第一天(含当日),格式为 YYYY-MM-DD。两个日期都省略时,默认为 end_date 前五年;仅提供 end_date 而省略此项,可获取截至该日期的全部可用历史。

响应
  • 200
    类型: object · ResponseE40Feb4D3D6B_InterestRatesResponse

    利率响应

    • interest_rates
      类型: array object[] · ResponseE40Feb4D3D6B_InterestRate[]
      • bank
        类型: string

        央行的代码。

      • date
        类型: string

        利率生效的日历日,格式为 YYYY-MM-DD。

      • name
        类型: string

        央行的名称。

      • rate
        类型: number

        当日政策利率,以百分比表示。对于美联储,为目标区间的中点。

    • next_page_url
      类型: string

      仅限历史数据。下一页结果的绝对 URL。仅在还有更多行时出现;按原样请求即可继续。每页最多 10 行。

    application/json
  • 400

    无法处理该请求。请检查请求参数。

  • 401

    需要有效的 Felo API 密钥。

  • 402

    由于未满足计费要求,请求无法继续。

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

    API 或计费服务暂时不可用。

  • 504

    服务在处理请求时超时。

  • default

    错误响应;上游透传响应可能采用提供方格式

    application/json
Request Example for get/v1/beta/financial/macro/interest-rates
curl 'https://openapi.felo.ai/v1/beta/financial/macro/interest-rates?bank=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "interest_rates": [
    {
      "bank": "string",
      "name": "string",
      "rate": 1,
      "date": "string"
    }
  ],
  "next_page_url": "string"
}
Interest Rates (Historical)

需要帮助?