GETKhả dụng
Minh bạch tài sản của sàn
Minh bạch tài sản của sàn (tổng số dư và mức thay đổi)
GET
/api/transparencyYêu cầu
Endpoint này không nhận tham số nào.
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/transparency"Trường phản hồi
Bảng trường được tạo từ phản hồi thật nên liệt kê đúng những gì endpoint trả về. Đường dẫn dùng a[] cho phần tử mảng và {*} cho object có khóa là tên động, chẳng hạn một coin hoặc một sàn.
| Trường | Kiểu | Đơn vị | Mô tả |
|---|---|---|---|
| success | boolean | — | true khi yêu cầu thành công. Khi thất bại, nội dung phản hồi là `{ success: false, code, error, request_id }`. |
| data | array | — | Dữ liệu trả về. |
| data[] | object | — | Dữ liệu trả về. |
| data[].ex | string | — | ID sàn, viết thường. |
| data[].name | string | — | Tên. |
| data[].slug | string | — | Mã định danh dùng được trong URL. |
| data[].dl_current_tvl | number | USD | Tổng tài sản trong các ví mà sàn công bố, lấy từ một trình theo dõi dự trữ bên thứ ba (ảnh chụp 6 giờ một lần mới nhất); null khi không được phủ. |
| data[].dl_inflow_24h | number | USD | Dòng tiền vào ròng các ví của sàn trong 24 giờ qua (âm = dòng tiền ra ròng), lấy từ trình theo dõi dự trữ bên thứ ba. |
| data[].dl_inflow_1w | number | USD | Dòng tiền vào ròng các ví của sàn trong 7 ngày qua (âm = dòng tiền ra ròng), lấy từ trình theo dõi dự trữ bên thứ ba. |
| data[].dl_val_chg_24h_pct | number|null | % | Thay đổi phần trăm của `dl_current_tvl` so với ảnh chụp đã lưu khoảng 24 giờ trước; null khi không có ảnh chụp nào như vậy. |
| data[].dl_val_chg_7d_pct | number|null | % | Thay đổi phần trăm của `dl_current_tvl` so với ảnh chụp đã lưu khoảng 7 ngày trước; null khi không có ảnh chụp nào như vậy. |
| data[].dl_spot_volume_24h | number|null | USD | Khối lượng giao dịch giao ngay 24 giờ của sàn theo báo cáo của trình theo dõi dự trữ bên thứ ba; null khi không được công bố. |
| data[].dl_oi_usd | number|null | USD | Vị thế mở phái sinh của sàn theo báo cáo của trình theo dõi dự trữ bên thứ ba; null khi không được công bố. |
| data[].dl_leverage | number|null | ratio | Vị thế mở ÷ tài sản trong ví theo báo cáo của trình theo dõi dự trữ bên thứ ba (0.25 = vị thế mở bằng 25 % tài sản). |
| data[].balance_usd | number | USD | Giá trị số dư. |
| data[].chg24h_pct | number|null | % | Thay đổi 24h tính theo phần trăm. |
| data[].chg7d_pct | number|null | % | Thay đổi 7 ngày tính theo phần trăm. |
| data[].chg30d_pct | number | % | Thay đổi 30 ngày theo phần trăm. |
| data[].snapshot_ts | number | ms | Thời điểm của ảnh chụp. |
| data[].dl_clean_assets_usd | number | USD | Tài sản trong ví không tính token nền tảng của chính sàn, theo định nghĩa của trình theo dõi dự trữ bên thứ ba. |
| data[].dl_deriv_volume_24h | number|null | USD | Khối lượng giao dịch phái sinh 24 giờ của sàn theo báo cáo của trình theo dõi dự trữ bên thứ ba; null khi không được công bố. |
| data[].dl_inflow_1m | number | USD | Dòng tiền vào ròng các ví của sàn trong một tháng qua (âm = dòng tiền ra ròng), lấy từ trình theo dõi dự trữ bên thứ ba. |
| data[].dl_ts | string | — | Chuỗi ngày giờ. |
| total | object | — | Tổng. |
| total.balance_usd | number | USD | Giá trị số dư. |
| total.chg24h_pct | number | % | Thay đổi 24h tính theo phần trăm. |
| total.exchanges | number | — | Các sàn. |
| total.total_oi_usd | number | USD | Tổng vị thế mở. |
| total.total_spot_volume_24h | number | USD | Tổng `dl_spot_volume_24h` trên mọi sàn được liệt kê có công bố giá trị này. |
| source_note | object | — | Ghi chú dạng văn bản tự do về nguồn gốc dữ liệu (hiện bằng tiếng Trung); khóa là `main` cho các cột `dl_*` và `balance` cho các cột số dư on-chain. |
| source_note.main | string | — | Ghi chú nguồn gốc cho các cột `dl_*` chính: một trình theo dõi dự trữ bên thứ ba, làm mới mỗi 6 giờ. |
| source_note.balance | string | — | Số dư tính bằng coin. |
Tạo lúc 2026-11-11 23:00 UTC từ 1 phản hồi thật.
Phản hồi mẫu
/api/transparency · Phản hồi thật, ghi lại lúc 2026-11-13 03:58:16 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 81 phần tử.
- "success"true
- "data"
- "total"
- "balance_usd"234756343839
- "chg24h_pct"12.532
- "exchanges"81
- "total_oi_usd"71437984575
- "total_spot_volume_24h"34707840494
- "source_note"
- "main""主展示列(资产/流入/价值变化/成交额/持仓/杠杆)采用交易所储备透明度的通用披露口径,数据源:DefiLlama CEX Transparency(api.llama.fi/cexs,每 6h 更新)"
- "balance""balance_usd/chg24h_pct/chg7d_pct/chg30d_pct 为 CoinBoss 自有链上钱包余额采集(地址标签法,每 6h 更新),作为次要参考列与主列并列展示,不与 DefiLlama 口径相加"
Chi tiết
- Xác thực
- Không cần. Endpoint công khai.
- Giới hạn tần suất
- 1200 yêu cầu mỗi phút cho mỗi IP
- Cache máy chủ
- 5m
- Micro-cache biên
- 10s
- Tần suất cập nhật
- mỗi 6 h; cache API 300 s
- Khung thời gian
- số dư hiện tại so với 24h / 7d / 30d trước; lịch sử theo ngày từ 2022-11
- Nguồn dữ liệu
- Số dư dự trữ on-chain của sàn và thay đổi 24h/7d/30d của chúng, lấy từ bộ dữ liệu minh bạch CEX của một nguồn bên thứ ba.
- Độ phủ sàn
- Khoảng 80 sàn tập trung; 26 tài sản lớn
- Phân trang
- không có
- Sắp xếp
- TVL hiện tại giảm dần
- Đơn vị
- USD and native token amounts; pct in percent
- Phương pháp
- pct = (cur / ref - 1) * 100, where ref is the latest point at or before target + 12h and not older than target - 5d
- Dấu thời gian
- Unix epoch tính bằng mili giây (UTC), trừ khi mô tả trường ghi khác
- Định dạng phản hồi
- json
- Độ ổn định
- Ổn định
Trạng thái trực tiếp
Khả dụngKiểm tra lúc 2026-11-13 03:58:16 UTCHTTP 20089 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 4.4h
Độ khả dụng, 30 ngày qua
100% trong 410 lần kiểm tra đạt
Lỗi
Lệnh gọi thất bại có chung một cấu trúc trên mọi endpoint. Danh sách đầy đủ nằm ở trang lỗi. Lỗi và giới hạn tần suất →
| Mã | HTTP | Ý nghĩa | Cách xử lý |
|---|---|---|---|
| INVALID_PARAM | 400 | Thiếu một tham số bắt buộc hoặc một giá trị không được chấp nhận. `param` nêu tên tham số khi xác định được. | Đừng thử lại với yêu cầu y nguyên; hãy sửa yêu cầu. |
| UNAUTHORIZED | 401 | Header `CB-API-KEY` đã được gửi nhưng khóa không tồn tại hoặc đã bị thu hồi. Dữ liệu công khai không cần khóa — hãy bỏ header hoặc dùng một khóa hợp lệ. | Đừng thử lại với yêu cầu y nguyên. |
| FORBIDDEN | 403 | Route này không thuộc API công khai (nội bộ hoặc chỉ dành cho tài khoản). | Đừng thử lại. |
| NOT_FOUND | 404 | Route không xác định, hoặc coin / sàn / quỹ được yêu cầu không tồn tại. | Đừng thử lại; hãy đối chiếu đường dẫn và các mã định danh với danh mục. |
| RATE_LIMITED | 429 | Số yêu cầu vượt quá giới hạn mỗi phút. `Retry-After` cho biết số giây cần chờ. | Chờ theo `Retry-After`, rồi thử lại có backoff. |
| INTERNAL | 500 | Lỗi máy chủ không mong đợi. Thông báo được cố ý viết chung chung; hãy trích dẫn `request_id` khi báo lỗi. | Thử lại một lần sau vài giây; nếu lỗi vẫn tiếp diễn, hãy báo cáo kèm ID yêu cầu. |
| UPSTREAM_FAILED | 503 | Nguồn dữ liệu đứng sau endpoint này không trả lời kịp thời. Không có số liệu quá hạn hay số liệu thay thế nào được trả về thay cho nó. | Thử lại có backoff; xem trang trạng thái. |
| UNAVAILABLE | 501 / 503 | Bộ dữ liệu tạm thời chưa sẵn sàng (cache đang được làm nóng) hoặc endpoint chưa có nguồn công khai hợp pháp. | Thử lại sau; danh mục có đánh dấu những endpoint không khả dụng theo thiết kế. |
| REQUEST_FAILED | 200 | Một số endpoint cũ hơn trả về HTTP 200 với `success: false`. Hãy luôn kiểm tra `success`, không chỉ trạng thái HTTP. | Tùy vào thông báo; hãy coi là một yêu cầu thất bại. |
Dùng thử
GET
/api/transparencyKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/transparencyChọn một endpoint rồi nhấn “Gửi yêu cầu”. Phản hồi, header và thời gian xử lý sẽ hiện ở đây.
Endpoint khác trong danh mục này
- Số dư on-chain của các sàn cho một coin /api/exchange-balances
- Chi tiết số dư của sàn /api/exchange-balances/exchange-detail
- Số dư on-chain theo coin của một sàn /api/exchange-balances/exchange/:ex
- Các sàn có dữ liệu số dư on-chain /api/exchange-balances/exchanges-list
- Lịch sử số dư của sàn /api/exchange-balances/history
- Danh sách số dư của sàn /api/exchange-balances/list
- Các ký hiệu được dữ liệu số dư sàn hỗ trợ /api/exchange-balances/symbols
- Tổng quan phái sinh của một sàn /api/exchanges/detail
- Danh sách thị trường phái sinh của một sàn /api/exchanges/markets
- Các coin biến động mạnh nhất trong một sàn /api/exchanges/movers
- Lịch sử vị thế mở của một sàn /api/exchanges/oi-history
- Xếp hạng sàn phái sinh /api/exchanges/ranking
- Tóm tắt số dư BTC trên sàn cho trang chủ /api/home/exchange-btc-balances
- Lịch sử thị phần khối lượng theo từng sàn /api/p3/volume/exchange-history
- Lịch sử dự trữ của sàn /api/reserves/history
- Tổng quan dự trữ của sàn /api/reserves/overview
- Minh bạch tài sản của sàn /api/transparency
- Thị phần của các sàn trong khối lượng BTC /api/volume/btc-ex-share
- Thị phần của các sàn trong khối lượng của một coin /api/volume/coin-ex-share
- Thị phần của các sàn trong khối lượng giao ngay /api/volume/spot-ex-share
- Khối lượng sàn Mỹ so với sàn offshore /api/volume/us-vs-offshore