v0.2.0-beta

OpenAPI 3.1.0

Thị trường đồng tiền

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

CoinGecko

Cryptocurrency prices, market data and historical series.

CoinGecko Thao tác

get/v1/beta/coingecko/coins/markets

Thị trường đồng tiền

Bảng thị trường có xếp hạng bao phủ nhiều đồng tiền trong một lần gọi: mỗi đồng tiền một hàng với current_price, market_cap, market_cap_rank, total_volume, high_24h, low_24h, price_change_percentage_24h, circulating_supply, total_supply, max_supply, ath và atl kèm ngày, và image. Phân trang bằng per_page và page, sắp xếp bằng order (vốn hóa thị trường, khối lượng hoặc id, tăng hoặc giảm), và thu hẹp bằng ids hoặc category. Truyền price_change_percentage để thêm trường price_change_percentage_24h_in_currency tương ứng. Dùng cho bảng xếp hạng và quét phân khúc. Với giá của vài đồng tiền đã biết, get_coingecko_simple_price nhẹ hơn nhiều; với một đồng tiền đầy đủ, dùng get_coingecko_coins_id.

Tham chiếu giá

Đo lường: Đơn vị tài nguyên theo gói.
Ước tính tham chiếu cho mỗi yêu cầu: USD 0.008.
Cơ sở chi phí đơn vị: USD 0.0.
Đơn vị tài nguyên: provider_credit.
Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.

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

category
Kiểu: string

Lọc theo danh mục của đồng tiền. *tham chiếu /coins/categories/list
ids
Kiểu: string

ID của các đồng tiền, phân tách bằng dấu phẩy nếu truy vấn nhiều hơn 1 đồng tiền. *tham chiếu /coins/list
include_rehypothecated
Kiểu: boolean

Bao gồm token tái cầm cố trong kết quả. Khi true, trả về trường market_cap_rank_with_rehypothecated. Mặc định: false
include_tokens
Kiểu: string enum

Khi tra cứu theo symbols, chỉ định all để bao gồm mọi token khớp. Mặc định top trả về các token xếp hạng cao nhất theo vốn hóa thị trường hoặc khối lượng.
giá trị
- top
- all
locale
Kiểu: string enum

Ngôn ngữ nền. Mặc định: en
giá trị
- ar
- bg
- cs
- da
- de
names
Kiểu: string

Tên của các đồng tiền, phân tách bằng dấu phẩy nếu truy vấn nhiều hơn 1 đồng tiền.
order
Kiểu: string enum

Sắp xếp kết quả theo trường. Mặc định: market_cap_desc
giá trị
- market_cap_asc
- market_cap_desc
- volume_asc
- volume_desc
- id_asc
- id_desc
page
Kiểu: integer

Phân trang kết quả. Mặc định: 1
per_page
Kiểu: integer

Tổng số kết quả mỗi trang. Mặc định: 100 Giá trị hợp lệ: 1...250
precision
Kiểu: string enum

Số chữ số thập phân cho giá trị giá tiền tệ
giá trị
- full
- 0
- 1
- 2
- 3
price_change_percentage
Kiểu: string

Bao gồm khung thời gian phần trăm thay đổi giá, phân tách bằng dấu phẩy nếu truy vấn nhiều hơn 1 khung. Giá trị hợp lệ: 1h, 24h, 7d, 14d, 30d, 200d, 1y
sparkline
Kiểu: boolean

Bao gồm dữ liệu sparkline 7 ngày. Mặc định: false
symbols
Kiểu: string

Ký hiệu của các đồng tiền, phân tách bằng dấu phẩy nếu truy vấn nhiều hơn 1 đồng tiền.
vs_currency
Kiểu: string
bắt buộc

Đơn vị tiền tệ đích của đồng tiền và dữ liệu thị trường. *tham chiếu /simple/supported_vs_currencies

Phản hồi

200
Kiểu: array object[] · Response860C3Ae68Ea5_CoinsMarkets

Danh sách đồng tiền kèm dữ liệu thị trường
ath
Kiểu: number | null
bắt buộc

Giá cao nhất mọi thời đại theo đơn vị tiền tệ đích

ath_change_percentage
Kiểu: number | null
bắt buộc

Tỷ lệ thay đổi mức cao nhất mọi thời đại

ath_date
Kiểu: string | null Định dạng: date-time
bắt buộc

Ngày đạt mức cao nhất mọi thời đại

atl
Kiểu: number | null
bắt buộc

Giá thấp nhất mọi thời đại theo đơn vị tiền tệ đích

atl_change_percentage
Kiểu: number | null
bắt buộc

Tỷ lệ thay đổi mức thấp nhất mọi thời đại

atl_date
Kiểu: string | null Định dạng: date-time
bắt buộc

Ngày đạt mức thấp nhất mọi thời đại

circulating_supply
Kiểu: number | null
bắt buộc

Nguồn cung lưu hành

current_price
Kiểu: number | null
bắt buộc

Giá hiện tại theo đơn vị tiền tệ đích

fully_diluted_valuation
Kiểu: number | null
bắt buộc

Định giá pha loãng hoàn toàn theo đơn vị tiền tệ đích

high_24h
Kiểu: number | null
bắt buộc

Giá cao nhất 24 giờ theo đơn vị tiền tệ đích

id
Kiểu: string
bắt buộc

ID đồng tiền

image
Kiểu: string
bắt buộc

URL hình ảnh của đồng tiền

last_updated
Kiểu: string Định dạng: date-time
bắt buộc

Dấu thời gian cập nhật lần cuối

low_24h
Kiểu: number | null
bắt buộc

Giá thấp nhất 24 giờ theo đơn vị tiền tệ đích

market_cap
Kiểu: number | null
bắt buộc

Vốn hóa thị trường theo đơn vị tiền tệ đích

market_cap_change_24h
Kiểu: number | null
bắt buộc

Thay đổi vốn hóa thị trường 24 giờ theo đơn vị tiền tệ đích

market_cap_change_percentage_24h
Kiểu: number | null
bắt buộc

Phần trăm thay đổi vốn hóa thị trường 24 giờ

market_cap_rank
Kiểu: integer | null
bắt buộc

Xếp hạng vốn hóa thị trường

max_supply
Kiểu: number | null
bắt buộc

Nguồn cung tối đa

name
Kiểu: string
bắt buộc

Tên đồng tiền

price_change_24h
Kiểu: number | null
bắt buộc

Thay đổi giá 24 giờ theo đơn vị tiền tệ đích

price_change_percentage_24h
Kiểu: number | null
bắt buộc

Phần trăm thay đổi giá 24 giờ

roi
Kiểu: object | null
bắt buộc

Dữ liệu lợi tức đầu tư

currency
Kiểu: string

Đơn vị tiền tệ của ROI

percentage
Kiểu: number

Phần trăm ROI

times
Kiểu: number

Hệ số nhân ROI

symbol
Kiểu: string
bắt buộc

Ký hiệu đồng tiền

total_supply
Kiểu: number | null
bắt buộc

Tổng nguồn cung

total_volume
Kiểu: number | null
bắt buộc

Tổng khối lượng giao dịch theo đơn vị tiền tệ đích

market_cap_rank_with_rehypothecated
Kiểu: integer | null

Xếp hạng vốn hóa thị trường bao gồm các token tái thế chấp

price_change_percentage_14d_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 14 ngày theo đơn vị tiền tệ đích

price_change_percentage_1h_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 1 giờ theo đơn vị tiền tệ đích

price_change_percentage_1y_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 1 năm theo đơn vị tiền tệ đích

price_change_percentage_200d_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 200 ngày theo đơn vị tiền tệ đích

price_change_percentage_24h_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 24 giờ theo đơn vị tiền tệ đích

price_change_percentage_30d_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 30 ngày theo đơn vị tiền tệ đích

price_change_percentage_7d_in_currency
Kiểu: number | null

Phần trăm thay đổi giá 7 ngày theo đơn vị tiền tệ đích

sparkline_in_7d
Kiểu: object

Dữ liệu giá sparkline trong 7 ngày qua

price
Kiểu: array number[]

Mảng các giá trị giá
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

get/v1/beta/coingecko/coins/markets

curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/markets?vs_currency=usd' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Hiện schema

[
  {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
    "current_price": 77671,
    "market_cap": 1555886872303,
    "market_cap_rank": 1,
    "fully_diluted_valuation": 1555914058873,
    "total_volume": 33235034316,
    "high_24h": 78419,
    "low_24h": 76696,
    "price_change_24h": -747.3360347281705,
    "price_change_percentage_24h": -0.95302,
    "market_cap_change_24h": -15184401491.513184,
    "market_cap_change_percentage_24h": -0.9665,
    "circulating_supply": 20030493,
    "total_supply": 20030843,
    "max_supply": 21000000,
    "ath": 126080,
    "ath_change_percentage": -38.39571,
    "ath_date": "2025-10-06T18:57:42.558Z",
    "atl": 67.81,
    "atl_change_percentage": 114443.23093,
    "atl_date": "2013-07-06T00:00:00.000Z",
    "roi": null,
    "last_updated": "2026-05-18T12:49:21.599Z",
    "market_cap_rank_with_rehypothecated": 1,
    "sparkline_in_7d": {
      "price": [
        81045.84776489827,
        81001.73089268175,
        80898.20817826076
      ]
    },
    "price_change_percentage_1h_in_currency": 0.5823392426906319,
    "price_change_percentage_24h_in_currency": -0.9530164743774191,
    "price_change_percentage_7d_in_currency": -4.042267423689584,
    "price_change_percentage_14d_in_currency": -1.5720857443461431,
    "price_change_percentage_30d_in_currency": 1.9453890367549207,
    "price_change_percentage_200d_in_currency": -29.452371850925864,
    "price_change_percentage_1y_in_currency": -25.214612207475373
  }
]

Danh sách đồng tiền kèm dữ liệu thị trường

Thị trường đồng tiền

Xác thựcRequired

CoinGecko

Thị trường đồng tiền

Tham chiếu giá