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ợ
ID không phân biệt chữ hoa chữ thường; phản hồi lặp lại ID chính xác như đã gửi. ID không được hỗ trợ trả về price: null với lý do là cảnh báo.
- Tiền điện tử:
crypto:<TICKER>-<QUOTE>— mọi mã giao dịch trên sàn giao dịch lớn đều được xử lý, bao gồm cả các đồng tiền đuôi dài (ví dụ:crypto:LTC-USD,crypto:TRX-USD,crypto:PEPE-USD).crypto:BTC-VNđược định giá bằng VNĐ.crypto:USDT-USDcó nguồn gốc từ nghịch đảo của cặp USD stablecoin (data_status: một phần).crypto:USDT-VN/crypto:USDC-VN(hoặccurrency=VN) sử dụng tỷ giá thị trường P2P (trung bình của 10 ưu đãi của người bán hàng đầu) vớibid/ask, quay trở lại giá USD × tỷ giá ngân hàng. - Forex:
fx:<BASE>-<QUOTE>hoặcforex:<BASE>-<QUOTE>, bất kỳ cặp ISO-4217 nào. Cặp VNĐ sử dụng bảng ngân hàng Việt Nam (bid= mua chuyển khoản,ask= bán), quay trở lại tỷ giá tham chiếu hàng ngày; các cặp khác sử dụng tỷ giá tham chiếu của ngân hàng trung ương. - Kim loại quý (giao ngay):
metal:XAU,metal:XAG,metal:XPT,metal:XPD— USD mỗi troy ounce; hợp đồng tương lai được sử dụng làm proxy được gắn cờ nếu nguồn giao ngay không thành công. - Vàng nội địa Việt Nam:
gold_vn:SJC,gold_vn:RING-9999(vàng Vòng 999.9),gold_vn:JEWELRY-9999, … — VNĐ mỗichi, bảng bán lẻ cóbid(giá mua vào) vàask(giá bán ra). - Chứng khoán / Cổ phiếu:
stock:<TICKER>có hậu tố trao đổi bên ngoài Hoa Kỳ (ví dụ:stock:AAPL,stock:VNM.VN). - Chỉ số thị trường:
index:^GSPC,index:NDX. - Hợp đồng tương lai hàng hóa:
tương lai:vàng,tương lai:bạc,tương lai:dầu thô,tương lai:brent_crude_oil.
⚙️ Đơn vị, Tiền tệ & Phụ
tiền tệ: Chuyển đổi sang bất kỳ loại tiền tệ ISO-4217 nào (ví dụ:USD,VD,EUR). Chuyển đổi sử dụng tỷ giá FX trực tiếp và được ghi chú trongcảnh báo.đơn vị: Các đơn vị khối lượng quy đổi cho nhau cho kim loại vàgold_vn:troy_ounce,g,kg,chi(3,75 g),luong(37,5 g). Các đơn vị được hỗ trợ khác:coin,barrel,share,point,currency. Một thiết bị không tương thích được báo cáo trong phầncảnh báo, không bao giờ được dán nhãn lại một cách âm thầm.rate_type: Đối với báo giá hai chiều (bid/askhiện tại: fx VNĐ,gold_vn, USDT/USDC bằng VNĐ), chọn bên nào trở thànhprice:mid(mặc định),buy(đại lý mua = giá mua vào, số tiền bạn nhận được khi bán),bán(đại lý bán = giá bán ra).
📊 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.delayed: 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).stale: Báo giá được biết đến lần cuối vượt quá ngưỡng mới.một phần: Áp dụng giá dự phòng hoặc giá phái sinh (xemcảnh báo).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,fx:USD-VN,metal:XAU,gold_vn:RING-9999); 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, kg, chi, luong cho kim loại) (e.g.coin) |
include_change |
boolean |
Bao gồm thay đổi giá 24 giờ và đóng cửa trước đó (e.g.true) |
rate_type |
string |
Which side of a two-way quote becomes mid) |
Responses
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",
"price": 67420.5,
"currency": "USD",
"unit": "coin",
"change_24h": 1620.5,
"change_24h_percent": 2.46,
"updated_at": 1774684800,
"data_status": "live"
},
{
"asset_id": "metal:XAU",
"name": "Gold Spot",
"price": 2350.75,
"currency": "USD",
"unit": "troy_ounce",
"change_24h": 10.75,
"change_24h_percent": 0.46,
"updated_at": 1774684800,
"data_status": "live"
}
]
}Response example (Currency Converted Quote (VND))
{
"data": [
{
"asset_id": "crypto:BTC-USD",
"name": "Bitcoin",
"price": 1715851725,
"currency": "VND",
"unit": "coin",
"change_24h": 41241725,
"change_24h_percent": 2.46,
"updated_at": 1774684800,
"data_status": "live"
}
]
}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']"
}
}
}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"
}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"
}
}
}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"
}
}
}