Felo API PlatformFelo API Platform
Tất cả endpoint của Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Lãi suất (lịch sử)

Máy chủ:https://openapi.felo.ai
Thư viện client

Financial Data

​

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

Lãi suất (lịch sử)

​

Lãi suất chính sách của một ngân hàng trung ương theo thời gian, dưới dạng mảng interest_rates gồm bank, name, date và rate. bank là bắt buộc và bị giới hạn bởi start_date và end_date. Một cạm bẫy đáng biết: mã phân biệt chữ hoa chữ thường và phải viết hoa — FED hoạt động, fed trả về HTTP 404 với "No data found", khiến người đọc tưởng là kết quả rỗng chứ không phải tham số sai. Các mã hợp lệ là FED, ECB, BOJ, BOE, BOC, RBA, PBOC, SNB, RBI và BOK; get_financial_macro_interest_rates_snapshot không có tham số sẽ liệt kê tất cả.

Tham chiếu giá

  • Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số truy vấn
  • bank
    Kiểu: string
    bắt buộc

    Mã ngân hàng trung ương, ví dụ FED, ECB, BOJ. Dùng endpoint /macro/interest-rates/banks để lấy danh sách ngân hàng khả dụng.

  • cursor
    Kiểu: string

    Con trỏ phân trang không trong suốt từ next_page_url của phản hồi trước. Khi được cung cấp, mọi tham số truy vấn khác đều bị bỏ qua: con trỏ mang theo các bộ lọc của yêu cầu gốc. Hãy đối xử với nó như một giá trị không trong suốt; không tự tạo hoặc sửa đổi.

  • end_date
    Kiểu: string

    Ngày cuối cùng cần trả về, bao gồm cả ngày đó, ở định dạng YYYY-MM-DD. Mặc định là hôm nay.

  • start_date
    Kiểu: string

    Ngày đầu tiên cần trả về, bao gồm cả ngày đó, ở định dạng YYYY-MM-DD. Mặc định là năm năm trước end_date khi cả hai ngày đều bị bỏ qua; bỏ qua trường này cùng với end_date để lấy toàn bộ lịch sử khả dụng tính đến ngày đó.

Phản hồi
  • 200
    Kiểu: object · ResponseE40Feb4D3D6B_InterestRatesResponse

    Phản hồi lãi suất

    • interest_rates
      Kiểu: array object[] · ResponseE40Feb4D3D6B_InterestRate[]
      • bank
        Kiểu: string

        Mã của ngân hàng trung ương.

      • date
        Kiểu: string

        Ngày lịch mà lãi suất có hiệu lực, ở định dạng YYYY-MM-DD.

      • name
        Kiểu: string

        Tên của ngân hàng trung ương.

      • rate
        Kiểu: number

        Lãi suất chính sách tính theo phần trăm vào ngày đó. Với Cục Dự trữ Liên bang, đây là điểm giữa của biên độ mục tiêu.

    • next_page_url
      Kiểu: string

      Chỉ trong lịch sử. URL tuyệt đối của trang kết quả tiếp theo. Chỉ xuất hiện khi còn hàng; hãy yêu cầu nguyên văn để tiếp tục. Mỗi trang chứa tối đa 10 hàng.

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    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)