GETKhả dụng
Danh sách stablecoin
Danh sách stablecoin (vốn hóa và mức thay đổi)
GET
/api/stablecoins/listYê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/stablecoins/list"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 }`. |
| updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| total_mcap_usd | number | USD | Tổng giá trị lưu hành của các stablecoin được liệt kê (100 đồng lớn nhất). |
| total_change_24h_pct | number | % | Thay đổi của `total_mcap_usd` so với tổng giá trị ngày trước đó của chính các coin đó do nguồn cung cấp; null khi không khả dụng. |
| usdt_dominance_pct | number | % | Giá trị lưu hành của USDT ÷ `total_mcap_usd` × 100; null khi thiếu USDT. |
| count | number | — | Số mục. |
| data | array | — | Dữ liệu trả về. |
| data[] | object | — | Dữ liệu trả về. |
| data[].id | string(decimal) | — | Định danh. |
| data[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| data[].name | string | — | Tên. |
| data[].gecko_id | string | — | Mã định danh của coin tại một nhà tổng hợp dữ liệu thị trường công khai, được chuyển nguyên từ nguồn; có thể là null. |
| data[].mechanism | string | — | Cơ chế neo giá theo phân loại của nguồn: `fiat-backed`, `crypto-backed` hoặc `algorithmic`. |
| data[].price | number|null | — | Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác). |
| data[].depeg | string | — | Trạng thái neo giá so với 1 USD: `ok` trong phạm vi 0.5 %, `warn` khi vượt 0.5 %, `depeg` khi vượt 2 %, `unknown` khi không có giá. |
| data[].depeg_pct | number|null | % | Độ lệch của `price` so với 1 USD: (price − 1) × 100; null khi không có giá. |
| data[].mcap_usd | number | USD | Vốn hóa thị trường. |
| data[].share_pct | number | % | Tỷ trọng trong tổng. |
| data[].change_24h_pct | number|null | % | Thay đổi 24h tính theo phần trăm. |
| data[].change_7d_pct | number|null | % | Thay đổi 7 ngày tính theo phần trăm. |
| data[].change_30d_pct | number|null | % | Thay đổi của giá trị lưu hành so với giá trị một tháng trước do nguồn cung cấp; null khi không khả dụng. |
Tạo lúc 2026-11-11 23:01 UTC từ 1 phản hồi thật.
Phản hồi mẫu
/api/stablecoins/list · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:27 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 100 phần tử.
- "success"true
- "updated_at"1794541801623
- "total_mcap_usd"287476086155.35986
- "total_change_24h_pct"-0.54
- "usdt_dominance_pct"60.97
- "count"100
- "data"
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ủ
- 2m
- Micro-cache biên
- 10s
- Tần suất cập nhật
- mỗi 10 phút; cache API 120 s
- Khung thời gian
- mới nhất; thay đổi so với ngày / tuần / tháng trước
- Nguồn dữ liệu
- Nguồn cung, giá và độ lệch neo giá của các stablecoin neo giá USD, từ API stablecoin của một nguồn bên thứ ba.
- Độ phủ sàn
- Top 100 stablecoin neo giá USD theo nguồn cung lưu hành (353 đồng được theo dõi)
- Phân trang
- cố định LIMIT 100
- Sắp xếp
- circulating_usd giảm dần
- Đơn vị
- USD; change in percent
- Phương pháp
- change = (circulating - prev) / prev * 100; depeg flag at 0.5% (warning) and 2% (severe) deviation from 1 USD
- 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:59:27 UTCHTTP 2001 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 9m
Độ khả dụng, 30 ngày qua
100% trong 408 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/stablecoins/listKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/stablecoins/listChọ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
- Chỉ số phái sinh toàn cầu /api/derivatives/global
- Gói thẻ chỉ báo cho trang chủ /api/home/indicator-cards
- Thẻ vĩ mô cho trang chủ /api/home/macro-cards
- Khối lượng giao ngay BTC theo tháng /api/indicators/cm/btc-spot-vol-monthly
- Khối lượng giao ngay crypto theo tháng /api/indicators/cm/crypto-spot-vol-monthly
- Lịch sử tổng vốn hóa crypto và vốn hóa các coin lớn /api/indicators/marketcap
- Vốn hóa crypto tách theo loại /api/indicators/marketcap-type
- Số liệu tổng hợp trên thanh ticker trang chủ /api/market/home-ticker
- Tổng quan thị trường phái sinh /api/market/overview
- Tỷ lệ khối lượng hợp đồng vĩnh cửu trên giao ngay theo ngày /api/p3/perp-spot-ratio
- Khối lượng hợp đồng vĩnh cửu so với giao ngay /api/p3/perp-spot-volume
- Chuỗi thời gian khối lượng toàn thị trường /api/p3/volume/history
- Tổng quan khối lượng /api/p3/volume/overview
- Lịch sử tổng vốn hóa stablecoin /api/stablecoins/chart
- Danh sách stablecoin /api/stablecoins/list
- Lịch sử mức thống trị của BTC /api/volume/btc-dominance-series
- Lịch sử khối lượng giao ngay / phái sinh toàn cầu /api/volume/global-history