Tóm tắt các chuyên mục toàn trang

Tóm tắt các chuyên mục toàn trang (cho các trang nội dung)

GET/api/content/summary

Yê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/content/summary"

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 }`.
now	number	ms	Thời gian máy chủ lúc phản hồi được dựng.
exchanges	object	—	Các sàn.
exchanges.count	number	—	Số mục.
exchanges.total_vol	number	USD	Khối lượng hợp đồng tương lai 24h cộng trên mọi sàn, không tính các hợp đồng gắn với cổ phiếu.
exchanges.total_oi	number	—	Tổng vị thế mở.
exchanges.total_contracts	number	count	Số ticker hợp đồng tương lai trên mọi sàn, không tính các hợp đồng gắn với cổ phiếu.
exchanges.top3	array	—	Ba mục đứng đầu.
exchanges.top3[]	object	—	Ba mục đứng đầu.
exchanges.top3[].name	string	—	Tên.
exchanges.top3[].vol	number	—	Khối lượng.
exchanges.top3[].share_pct	number	%	Tỷ trọng trong tổng.
exchanges.dex_share_vol_pct	number	%	Tỷ trọng của `total_vol` được giao dịch trên các sàn hợp đồng vĩnh cửu phi tập trung.
exchanges.dex_share_oi_pct	number	%	Tỷ trọng của `total_oi` nằm trên các sàn hợp đồng vĩnh cửu phi tập trung.
exchanges.stock_vol_excluded	number	USD	Khối lượng 24h của các hợp đồng gắn với cổ phiếu đã bị loại khỏi `total_vol`.
funding	object	—	Khối hoặc giá trị tỷ lệ funding.
funding.weighted_pct	number	%	Tỷ lệ funding hiện tại của các hợp đồng vĩnh cửu USDT crypto, gia quyền theo vị thế mở, tính bằng phần trăm cho mỗi chu kỳ funding (các tỷ lệ không được chuẩn hóa về 8 giờ).
funding.top_pos	array	—	Ba tỷ lệ funding hiện tại cao nhất trong các hợp đồng vĩnh cửu USDT có vị thế mở tối thiểu 300,000 USD.
funding.top_pos[]	object	—	Một hợp đồng: `base` (coin), `ex` (tên hiển thị của sàn) và `rate_pct`.
funding.top_pos[].base	string	—	Ký hiệu tài sản cơ sở.
funding.top_pos[].ex	string	—	ID sàn, viết thường.
funding.top_pos[].rate_pct	number	%	Tỷ lệ funding hiện tại của hợp đồng tính bằng phần trăm, theo chu kỳ funding của chính nó.
funding.top_neg	array	—	Ba tỷ lệ funding hiện tại thấp nhất (âm nhiều nhất) trong các hợp đồng vĩnh cửu USDT có vị thế mở tối thiểu 300,000 USD.
funding.top_neg[]	object	—	Một hợp đồng: `base` (coin), `ex` (tên hiển thị của sàn) và `rate_pct`.
funding.top_neg[].base	string	—	Ký hiệu tài sản cơ sở.
funding.top_neg[].ex	string	—	ID sàn, viết thường.
funding.top_neg[].rate_pct	number	%	Tỷ lệ funding hiện tại của hợp đồng tính bằng phần trăm, theo chu kỳ funding của chính nó.
funding.intervals	object	—	Các chu kỳ.
funding.intervals.h1_pct	number	%	Tỷ trọng các hợp đồng đã thanh toán funding từ 16 lần trở lên trong 24 giờ qua (được xếp loại theo giờ).
funding.intervals.h4_pct	number	%	Tỷ trọng các hợp đồng đã thanh toán funding từ 5 đến 15 lần trong 24 giờ qua (được xếp loại 4 giờ).
funding.intervals.h8_pct	number	%	Tỷ trọng các hợp đồng đã thanh toán funding dưới 5 lần trong 24 giờ qua (được xếp loại 8 giờ).
oi	object	—	Vị thế mở.
oi.total	number	—	Tổng.
oi.chg24_pct	number	%	Thay đổi của tổng vị thế mở so với ảnh chụp theo giờ của khoảng 24 giờ trước đó, tính trên các hợp đồng có mặt ở cả hai; null khi không có ảnh chụp nào.
oi.gainers	array	—	Các mức tăng lớn nhất.
oi.gainers[]	object	—	Các mức tăng lớn nhất.
oi.gainers[].base	string	—	Ký hiệu tài sản cơ sở.
oi.gainers[].oi	number	—	Vị thế mở.
oi.gainers[].chg_pct	number	%	Thay đổi tính theo phần trăm.
oi.losers	array	—	Các mức giảm lớn nhất.
oi.losers[]	object	—	Các mức giảm lớn nhất.
oi.losers[].base	string	—	Ký hiệu tài sản cơ sở.
oi.losers[].oi	number	—	Vị thế mở.
oi.losers[].chg_pct	number	%	Thay đổi tính theo phần trăm.
oi.top_ex	array	—	Ba sàn có vị thế mở lớn nhất.
oi.top_ex[]	object	—	Một sàn: `name`, `oi` (USD) và `share_pct` (% của `oi.total`).
oi.top_ex[].name	string	—	Tên.
oi.top_ex[].oi	number	—	Vị thế mở.
oi.top_ex[].share_pct	number	%	Tỷ trọng trong tổng.
market	object	—	Thị trường.
market.total_oi	number	—	Tổng vị thế mở.
market.liq_total	number	USD	Thanh lý long cộng short trong 24 giờ qua, không tính các hợp đồng gắn với cổ phiếu.
market.liq_long	number	—	Vị thế long bị thanh lý.
market.liq_short	number	—	Vị thế short bị thanh lý.
market.up_cnt	number	count	Số coin trong top 500 theo vốn hóa có thay đổi giá 24h dương.
market.down_cnt	number	count	Số coin trong top 500 theo vốn hóa có thay đổi giá 24h âm.
market.btc_dom_pct	number	%	Vốn hóa BTC ÷ tổng vốn hóa của các coin được theo dõi × 100; null khi ảnh chụp vốn hóa không khả dụng.
stocks	object	—	Các hợp đồng vĩnh cửu gắn với cổ phiếu có ticker trong 12 giờ qua: số tài sản cơ sở, số hợp đồng, số sàn, khối lượng 24h và 3 tài sản cơ sở hàng đầu.
stocks.underlyings	number	—	Ký hiệu các tài sản cơ sở.
stocks.contracts	number	—	Các dòng theo từng hợp đồng.
stocks.vol	number	—	Khối lượng.
stocks.exchanges	number	—	Các sàn.
stocks.top3	array	—	Ba mục đứng đầu.
stocks.top3[]	object	—	Ba mục đứng đầu.
stocks.top3[].u	string	—	Mã của cổ phiếu hoặc ETF cơ sở.
stocks.top3[].vol	number	—	Khối lượng.
preipo	object	—	Các tài sản cơ sở pre-IPO (tổng hợp) trong số các hợp đồng gắn với cổ phiếu: số lượng, khối lượng 24h, giá cao nhất và chênh lệch giá rộng nhất.
preipo.underlyings	number	—	Ký hiệu các tài sản cơ sở.
preipo.vol	number	—	Khối lượng.
preipo.top_price	object	—	Tài sản cơ sở pre-IPO có giá hợp đồng gia quyền theo khối lượng cao nhất (`u`, `price`); null khi không có tài sản nào được giao dịch.
preipo.top_price.u	string	—	Tên của tài sản cơ sở đó.
preipo.top_price.price	number	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
preipo.max_spread	object	—	Tài sản cơ sở pre-IPO có khoảng chênh giá rộng nhất giữa các hợp đồng của nó (`u`, `spread_pct`, `pmin`, `pmax`); null khi không tài sản nào có hai hợp đồng.
preipo.max_spread.u	string	—	Tên của tài sản cơ sở đó.
preipo.max_spread.spread_pct	number	%	(`pmax` − `pmin`) ÷ `pmin` × 100.
preipo.max_spread.pmin	number	USD	Giá hợp đồng hiện tại thấp nhất của tài sản cơ sở trên các sàn.
preipo.max_spread.pmax	number	USD	Giá hợp đồng hiện tại cao nhất của tài sản cơ sở trên các sàn.

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/content/summary · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:32 UTC. Mảng và map dài được rút gọn khi hiển thị: oi.losers có 3 phần tử; oi.top_ex có 3 phần tử; oi.gainers có 3 phần tử; stocks.top3 có 3 phần tử; exchanges.top3 có 3 phần tử; funding.top_neg có 3 phần tử.

{
- "success": true,
- "now": 1794542372009,
- "exchanges": {
  - "count": 25,
  - "total_vol": 176285468302.16,
  - "total_oi": 107132161363.71,
  - "total_contracts": 10843,
  - "top3": [ … 2 ],
  - "dex_share_vol_pct": 8.3,
  - "dex_share_oi_pct": 11.3,
  - "stock_vol_excluded": 41399911752.17
  },
- "funding": {
  - "weighted_pct": 0.0045,
  - "top_pos": [ … 2 ],
  - "top_neg": [ … 2 ],
  - "intervals": { … 3 }
  },
- "oi": {
  - "total": 107132161363.71,
  - "chg24_pct": -3.93,
  - "gainers": [ … 2 ],
  - "losers": [ … 2 ],
  - "top_ex": [ … 2 ]
  },
- "market": {
  - "total_oi": 107132161363.71,
  - "liq_total": 1363492414.84,
  - "liq_long": 1267532610.54,
  - "liq_short": 95959804.3,
  - "up_cnt": 150,
  - "down_cnt": 327,
  - "btc_dom_pct": 57.4
  },
- "stocks": {
  - "underlyings": 648,
  - "contracts": 2338,
  - "vol": 41305485625.189865,
  - "exchanges": 18,
  - "top3": [ … 2 ]
  },
- "preipo": {
  - "underlyings": 3,
  - "vol": 2217117745.7,
  - "top_price": { … 2 },
  - "max_spread": { … 4 }
  }
}

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ủ: 10m
Micro-cache biên: 10s
Tần suất cập nhật: ticker mỗi 1 phút; OI/funding mỗi 5 phút; cache API 600 s
Khung thời gian: 24h
Nguồn dữ liệu: Các số liệu tóm tắt toàn trang (thị phần khối lượng và OI theo sàn, các cực trị funding, các coin biến động OI mạnh, thanh lý, thống kê hợp đồng cổ phiếu token hóa và pre-IPO) do CoinBoss tự tổng hợp từ dữ liệu sàn; tỷ lệ thống trị của BTC và số coin tăng/giảm từ một nhà tổng hợp dữ liệu thị trường bên thứ ba.
Độ phủ sàn: Mọi sàn phái sinh được thu thập; hợp đồng cổ phiếu token hóa không được tính vào các tổng crypto
Phân trang: không có
Đơn vị: USD; percentages
Phương pháp: funding.weighted_pct = SUM(rate * oi) / SUM(oi) * 100 over USDT perpetuals refreshed within 3h (not normalized to 8h); oi.chg24_pct compares contracts present both now and 24h ago
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: Beta

Trạng thái trực tiếp

Khả dụngKiểm tra lúc 2026-11-13 03:59:32 UTCHTTP 200342 msSchema khớp

Độ khả dụng, 30 ngày qua

99.75% 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/content/summaryKhả dụng

Tham số

Không có tham số.

URL yêu cầuhttps://www.coinboss.com/api/content/summary

Chọ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.

Ma trận chất lượng dữ liệu (góc nhìn trình thu thập) /api/sd/quality
Danh mục API /api/meta/catalog
Nhật ký thay đổi và chính sách phiên bản /api/meta/changelog
Tài liệu endpoint /api/meta/endpoint
Tài liệu OpenAPI /api/meta/openapi
Ma trận chất lượng dữ liệu /api/meta/quality
Trạng thái dịch vụ /api/meta/status
Kiểm tra một ký hiệu coin có được nền tảng nhận biết hay không /api/coin-exists
Bảng ánh xạ từ ký hiệu coin sang đường dẫn icon lưu cục bộ /api/coin-icons
Tóm tắt tổng hợp của trang coin /api/content/coin
Tóm tắt các chuyên mục toàn trang /api/content/summary
Bảng tỷ giá tiền pháp định /api/currency/fx
Bảng ánh xạ từ id sàn sang đường dẫn icon lưu cục bộ /api/exchange-icons
Kiểm tra liveness /api/health
Thống kê trang nghiên cứu /api/research/stats