Nhận báo giá chuẩn hóa hiện tại cho tài sản - điểm yêu cầu: 0,20
Nhận báo giá chuẩn hóa theo thời gian thực và gần thời gian thực cho tối đa 20 ID tài sản chuẩn trong một yêu cầu.
👉 Định dạng ID nội dung Canonical được hỗ trợ
- Tiền điện tử:
tiền điện tử:BTC-USD,tiền điện tử:ETH-USD,tiền điện tử:SOL-USD - Kim loại quý:
metal:XAU(Vàng),metal:XAG(Bạc) - Cổ phiếu / Cổ phiếu:
stock:AAPL,stock:NVDA,stock:TSLA - Cặp ngoại hối:
forex:EUR-USD,forex:USD-JPY,forex:USD-USD - Chỉ số thị trường:
index:SPX,index:NDX - Chỉ báo vĩ mô:
macro:FEDFUNDS,macro:DGS10
⚙️ Chuyển đổi đơn vị và tiền tệ
currency: Chuyển đổi giá thành loại tiền định giá tiêu chuẩn ISO-4217 (ví dụ:USD,đồng,EUR).đơn vị: Chuyển đổi đơn vị định giá (ví dụ:troy_ounce,g,kgđối với kim loại quý). Đơn vị được hỗ trợ:coin,troy_ounce,g,kg,barrel,share,point,currency.
📊 Trạng thái dữ liệu (data_status)
live: Dữ liệu thời gian thực từ nhà cung cấp thị trường sơ cấp.bị trì hoãn: Dữ liệu của nhà cung cấp thị trường bị trì hoãn (ví dụ: thị trường chứng khoán bị trễ 15 phút).market_closed: Thị trường hiện đang đóng cửa (ví dụ: thị trường chứng khoán cuối tuần truyền thống).stale: Báo giá được biết lần cuối vượt quá ngưỡng mới.một phần: Áp dụng giá dự phòng hoặc bỏ qua các trường tùy chọn.unavailable: Dữ liệu tạm thời không có sẵn từ nhà cung cấp.
💳 Giới hạn thanh toán và tỷ giá
- Chi phí: 0,20 điểm tín dụng cho mỗi yêu cầu.
- Giới hạn tốc độ: 60 yêu cầu mỗi giây.
Parameters
query
| Name | Type | Description |
|---|---|---|
assets* |
string |
ID tài sản chuẩn được phân tách bằng dấu phẩy (ví dụ: tiền điện tử:BTC-USD,metal:XAU); tối đa 20 (e.g.crypto:BTC-USD,metal:XAU) |
currency |
string |
Chuyển đổi tiền tệ báo giá ISO-4217 (ví dụ: USD, EUR, VNĐ) (e.g.USD) |
unit |
string |
Chuyển đổi đơn vị tương thích (ví dụ: troy_ounce, g, coin) (e.g.coin) |
include_change |
boolean |
Bao gồm thay đổi giá 24 giờ và đóng cửa trước đó (e.g.true) |
Responses
200
Phản hồi thành công trả về báo giá tài sản chuẩn hóa
Response schema
| Property | Type | Description |
|---|---|---|
data* |
array[object] |
Danh sách báo giá thị trường khớp lệnh yêu cầu |
Response example (Crypto & Precious Metal Quotes)
{
"data": [
{
"asset_id": "crypto:BTC-USD",
"name": "Bitcoin",
"symbol": "BTC-USD",
"price": 67420.5,
"currency": "USD",
"unit": "coin",
"exchange": "Binance",
"previous_close": 65800,
"change_24h": 1620.5,
"change_24h_percent": 2.46,
"market_state": "24_7",
"source": "binance",
"source_timestamp": 1774684800,
"retrieved_at": 1774684802,
"freshness_seconds": 2,
"data_status": "live",
"warnings": []
},
{
"asset_id": "metal:XAU",
"name": "Gold Spot",
"symbol": "XAU",
"price": 2350.75,
"currency": "USD",
"unit": "troy_ounce",
"exchange": "COMMODITY",
"previous_close": 2340,
"change_24h": 10.75,
"change_24h_percent": 0.46,
"market_state": "open",
"source": "yahoo_finance",
"source_timestamp": 1774684800,
"retrieved_at": 1774684802,
"freshness_seconds": 2,
"data_status": "live",
"warnings": []
}
]
}Response example (Currency Converted Quote (VND))
{
"data": [
{
"asset_id": "crypto:BTC-USD",
"name": "Bitcoin",
"symbol": "BTC-USD",
"price": 1715851725,
"currency": "VND",
"unit": "coin",
"exchange": "Binance",
"previous_close": 1674610000,
"change_24h": 41241725,
"change_24h_percent": 2.46,
"market_state": "24_7",
"source": "binance",
"source_timestamp": 1774684800,
"retrieved_at": 1774684802,
"freshness_seconds": 2,
"data_status": "live",
"warnings": []
}
]
}
400
Yêu cầu không hợp lệ - Tham số truy vấn không hợp lệ hoặc đơn vị không được hỗ trợ
Response example
{
"detail": {
"error": {
"code": 400,
"message": "unit must be one of ['barrel', 'coin', 'currency', 'g', 'kg', 'point', 'share', 'troy_ounce']"
}
}
}
401
Trái phép - Tiêu đề X-Api-Key bị thiếu hoặc không hợp lệ
Response example
{
"statusCode": 401,
"error": "Unauthorized",
"message": "api_key: Invalid credentials"
}
422
Thực thể không thể xử lý - Xác thực yêu cầu không thành công (ví dụ: >20 nội dung hoặc mã tiền tệ không hợp lệ)
Response example
{
"detail": {
"error": {
"code": 422,
"message": "Maximum 20 assets allowed per request"
}
}
}
502
Cổng xấu - Lỗi kết nối hoặc truy xuất nhà cung cấp dữ liệu
Response example
{
"detail": {
"error": {
"code": 502,
"message": "Upstream market data provider error"
}
}
}