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)

需要協助嗎?