Khối lượng 24h—Vị thế mở—Thanh lý 24h$1.36B Long/Short 24h—Thống trị BTC—Thống trị ETH—

Ứng dụng

Ngôn ngữ ▾

₫ VND ▾

/api/sd/funding

GETKhả dụng

Funding của một coin

Lớp dữ liệu tự thu thập: funding của một coin (chuẩn hóa 8h, có trọng số)

GET/api/sd/funding

Yêu cầu

Tham số truy vấn

Tên	Kiểu	Bắt buộc	Mặc định	Giá trị hợp lệ	Mô tả
coin	string	Bắt buộc	—	—	Ký hiệu coin; 400 khi thiếu. Bí danh: `base`. Ví dụ: BTC

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/sd/funding?coin=BTC"

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 }`.
coin	string	—	Ký hiệu coin, viết hoa (ví dụ BTC).
now	number	ms	Thời gian máy chủ lúc phản hồi được dựng.
unit	string	—	Đơn vị của mọi trường tỷ lệ trong phản hồi này: `fraction` (0.0001 = 0.01 %).
avg_8h	number	fraction per 8h	Trung bình cộng của các tỷ lệ đã chuẩn hóa 8h, mỗi sàn một hợp đồng.
oi_weighted_8h	number	fraction per 8h	Trung bình trọng số theo vị thế mở của các tỷ lệ đã chuẩn hóa 8h.
apr_pct	number	% per year	Quy năm đơn giản: tỷ lệ 8h × 3 × 365 × 100.
apr_basis	string	—	`apr_pct` chính dựa trên số liệu tổng hợp nào.
n_exchanges	number	—	Số sàn đóng góp dữ liệu.
n_normalized	number	—	Các sàn đã biết chu kỳ funding và có thể chuẩn hóa về 8h.
n_unknown_interval	number	—	Các sàn bị loại khỏi số liệu tổng hợp vì không rõ chu kỳ funding.
settled_cum_7d	object	—	Tổng các tỷ lệ funding đã thực sự thanh toán trong 7 ngày qua, lấy trung bình trên các sàn có lịch sử thanh toán.
settled_cum_7d.avg	number	fraction	Trung bình cộng trên các sàn.
settled_cum_7d.oi_weighted	number	fraction	Trung bình trọng số theo vị thế mở.
settled_cum_7d.n	number	—	Các sàn có đủ dữ liệu cho cả khung thời gian.
settled_cum_30d	object	—	Tương tự, trong 30 ngày.
settled_cum_30d.avg	number	fraction	Trung bình cộng trên các sàn.
settled_cum_30d.oi_weighted	number	fraction	Trung bình trọng số theo vị thế mở.
settled_cum_30d.n	number	—	Các sàn có đủ dữ liệu cho cả khung thời gian.
by_exchange	array	—	Mỗi sàn một dòng: hợp đồng chính của sàn cho coin này (hợp đồng có vị thế mở lớn nhất).
by_exchange[]	object	—	Phần tách theo từng sàn.
by_exchange[].exchange	string	—	ID sàn, viết thường (ví dụ `binance`).
by_exchange[].symbol	string	—	Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT).
by_exchange[].margin	string	—	Nhóm đồng ký quỹ.
by_exchange[].kind	string	—	Loại.
by_exchange[].primary	boolean	—	true với hợp đồng đại diện cho sàn trong các số liệu tổng hợp.
by_exchange[].rate	number	—	Tỷ lệ funding của kỳ hiện tại, đúng như sàn công bố.
by_exchange[].interval_h	number	h	Chu kỳ funding.
by_exchange[].rate_8h	number	—	Tỷ lệ chuẩn hóa về kỳ 8 giờ: rate × 8 / interval_h.
by_exchange[].apr_pct	number	% per year	Phần trăm quy năm.
by_exchange[].next_funding_time	number\|null	ms	Thời điểm thanh toán tiếp theo.
by_exchange[].next_derived	boolean	—	true khi thời điểm thanh toán tiếp theo được suy ra từ chu kỳ funding thay vì do sàn công bố.
by_exchange[].predicted_rate	null	—	Tỷ lệ tham khảo của kỳ tiếp theo nếu sàn có công bố; nếu không thì null.
by_exchange[].oi_usd	number\|null	USD	Vị thế mở tính theo giá trị danh nghĩa USD.
by_exchange[].updated_at	number	ms	Thời điểm dòng này được cập nhật lần cuối.
by_exchange[].age_s	number	s	Số giây kể từ lần cập nhật gần nhất của dòng này.
by_exchange[].is_stale	boolean	—	true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng.
by_exchange[].settled	object\|null	—	Các bản ghi thanh toán thực tế của hợp đồng này; null khi sàn không có lịch sử công khai.
by_exchange[].settled.last_rate	number	—	Tỷ lệ của kỳ thanh toán gần nhất. có thể vắng mặt
by_exchange[].settled.last_time	number	ms	Thời điểm của kỳ thanh toán gần nhất. có thể vắng mặt
by_exchange[].settled.interval_h	number	h	Chu kỳ funding. có thể vắng mặt
by_exchange[].settled.cum_7d	number	—	Tổng các tỷ lệ đã thanh toán trong 7 ngày qua. có thể vắng mặt
by_exchange[].settled.n_7d	number	—	Số kỳ thanh toán tìm thấy trong 7 ngày qua. có thể vắng mặt
by_exchange[].settled.n_7d_expected	number	—	Số kỳ thanh toán dự kiến trong 7 ngày với chu kỳ này. có thể vắng mặt
by_exchange[].settled.cum_7d_complete	boolean	—	true khi không thiếu kỳ thanh toán nào trong khung 7 ngày. có thể vắng mặt
by_exchange[].settled.cum_30d	number	—	Tổng các tỷ lệ đã thanh toán trong 30 ngày qua. có thể vắng mặt
by_exchange[].settled.n_30d	number	—	Số kỳ thanh toán tìm thấy trong 30 ngày qua. có thể vắng mặt
by_exchange[].settled.n_30d_expected	number	—	Số kỳ thanh toán dự kiến trong 30 ngày với chu kỳ này. có thể vắng mặt
by_exchange[].settled.cum_30d_complete	boolean	—	true khi không thiếu kỳ thanh toán nào trong khung 30 ngày. có thể vắng mặt
by_exchange[].settled.history_from	number	ms	Bản ghi thanh toán sớm nhất đang lưu của hợp đồng này. có thể vắng mặt
other_contracts	array	—	Các hợp đồng khác của cùng coin (USDC, ký quỹ bằng coin, …). Không nằm trong số liệu tổng hợp.
other_contracts[]	object	—	Một hợp đồng funding bổ sung của sàn (ký quỹ bằng coin, USDC, …), không phải hợp đồng chính của sàn và bị loại khỏi các số liệu tổng hợp.
other_contracts[].exchange	string	—	ID sàn, viết thường (ví dụ `binance`).
other_contracts[].symbol	string	—	Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT).
other_contracts[].margin	string	—	Nhóm đồng ký quỹ.
other_contracts[].kind	string	—	Loại.
other_contracts[].primary	boolean	—	true với hợp đồng đại diện cho sàn trong các số liệu tổng hợp.
other_contracts[].rate	number	—	Tỷ lệ funding của kỳ hiện tại, đúng như sàn công bố.
other_contracts[].interval_h	number\|null	h	Chu kỳ funding.
other_contracts[].rate_8h	number\|null	—	Tỷ lệ chuẩn hóa về kỳ 8 giờ: rate × 8 / interval_h.
other_contracts[].apr_pct	number\|null	% per year	Phần trăm quy năm.
other_contracts[].next_funding_time	number\|null	ms	Thời điểm thanh toán tiếp theo.
other_contracts[].next_derived	boolean	—	true khi thời điểm thanh toán tiếp theo được suy ra từ chu kỳ funding thay vì do sàn công bố.
other_contracts[].predicted_rate	number\|null	—	Tỷ lệ tham khảo của kỳ tiếp theo nếu sàn có công bố; nếu không thì null.
other_contracts[].oi_usd	number\|null	USD	Vị thế mở tính theo giá trị danh nghĩa USD.
other_contracts[].updated_at	number	ms	Thời điểm dòng này được cập nhật lần cuối.
other_contracts[].age_s	number	s	Số giây kể từ lần cập nhật gần nhất của dòng này.
other_contracts[].is_stale	boolean	—	true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng.
other_contracts[].settled	object\|null	—	Các bản ghi thanh toán thực tế của hợp đồng này; null khi sàn không có lịch sử công khai.
other_contracts[].settled.last_rate	number	—	Tỷ lệ của kỳ thanh toán gần nhất. có thể vắng mặt
other_contracts[].settled.last_time	number	ms	Thời điểm của kỳ thanh toán gần nhất. có thể vắng mặt
other_contracts[].settled.interval_h	number	h	Chu kỳ funding. có thể vắng mặt
other_contracts[].settled.cum_7d	number	—	Tổng các tỷ lệ đã thanh toán trong 7 ngày qua. có thể vắng mặt
other_contracts[].settled.n_7d	number	—	Số kỳ thanh toán tìm thấy trong 7 ngày qua. có thể vắng mặt
other_contracts[].settled.n_7d_expected	number	—	Số kỳ thanh toán dự kiến trong 7 ngày với chu kỳ này. có thể vắng mặt
other_contracts[].settled.cum_7d_complete	boolean	—	true khi không thiếu kỳ thanh toán nào trong khung 7 ngày. có thể vắng mặt
other_contracts[].settled.cum_30d	number	—	Tổng các tỷ lệ đã thanh toán trong 30 ngày qua. có thể vắng mặt
other_contracts[].settled.n_30d	number	—	Số kỳ thanh toán tìm thấy trong 30 ngày qua. có thể vắng mặt
other_contracts[].settled.n_30d_expected	number	—	Số kỳ thanh toán dự kiến trong 30 ngày với chu kỳ này. có thể vắng mặt
other_contracts[].settled.cum_30d_complete	boolean	—	true khi không thiếu kỳ thanh toán nào trong khung 30 ngày. có thể vắng mặt
other_contracts[].settled.history_from	number	ms	Bản ghi thanh toán sớm nhất đang lưu của hợp đồng này. có thể vắng mặt
coverage	object	—	Những gì được tính và không được tính trong các con số ở trên. Hãy so sánh phần này trước khi so sánh tổng với một nguồn khác.
coverage.settle_history_exchanges	array	—	Các sàn được thu thập bản ghi thanh toán thực tế.
coverage.settle_history_exchanges[]	string	—	ID của sàn có bản ghi thanh toán funding thực tế được thu thập cho coin này.
coverage.no_settle_history	array	—	Các sàn không có nguồn lịch sử thanh toán công khai; `settled` của chúng là null.
coverage.no_settle_history[]	string	—	ID sàn của một hợp đồng chính không có lịch sử thanh toán được thu thập, nên khối `settled` của nó là null.
coverage.unknown_interval	array	—	Các dòng không xác định được chu kỳ funding. rỗng trong các mẫu dùng để tạo bảng này
coverage.no_liveness_excluded	array	—	Các dòng bị loại vì hợp đồng không có dấu hiệu giao dịch (không có ticker, vị thế mở hay báo giá gần đây). rỗng trong các mẫu dùng để tạo bảng này
method	object	—	Diễn giải dạng văn bản thuần về các công thức dùng cho phản hồi này.
method.rate	string	—	Tỷ lệ funding của kỳ hiện tại, đúng như sàn công bố.
method.rate_8h	string	—	Tỷ lệ chuẩn hóa về kỳ 8 giờ: rate × 8 / interval_h.
method.apr_pct	string	% per year	Phần trăm quy năm.
method.aggregate	string	—	Số liệu tổng hợp trên các sàn.
method.settled	string	—	Các bản ghi thanh toán thực tế của hợp đồng này; null khi sàn không có lịch sử công khai.
method.predicted_rate	string	—	Tỷ lệ tham khảo của kỳ tiếp theo nếu sàn có công bố; nếu không thì null.
method.liveness	string	—	Quy tắc dạng văn bản thuần để loại hợp đồng không còn hoạt động: một dòng funding chỉ được tính khi có ticker trong vòng 1h, vị thế mở trong vòng 3h hoặc báo giá riêng trong vòng 3h.

Tạo lúc 2026-11-11 23:00 UTC từ 4 phản hồi thật.

Phản hồi mẫu

/api/sd/funding?coin=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 04:02:35 UTC. Mảng và map dài được rút gọn khi hiển thị: by_exchange có 23 phần tử; other_contracts có 18 phần tử; coverage.settle_history_exchanges có 16 phần tử.

{
- "success": true,
- "coin": "BTC",
- "now": 1794542555395,
- "unit": "fraction",
- "avg_8h": 0.00005823565217391305,
- "oi_weighted_8h": 0.000055271734505874884,
- "apr_pct": 6.0523,
- "apr_basis": "oi_weighted_8h",
- "n_exchanges": 23,
- "n_normalized": 23,
- "n_unknown_interval": 0,
- "settled_cum_7d": {
  - "avg": 0.001605814,
  - "oi_weighted": 0.0015308150106440065,
  - "n": 15
  },
- "settled_cum_30d": {
  - "avg": 0.006684665333333334,
  - "oi_weighted": 0.006363754085135786,
  - "n": 15
  },
- "by_exchange": [
  - { … 17 },
  - { … 17 }
  ],
- "other_contracts": [
  - { … 17 },
  - { … 17 }
  ],
- "coverage": {
  - "settle_history_exchanges": [ … 8 ],
  - "no_settle_history": [ … 7 ],
  - "unknown_interval": [],
  - "no_liveness_excluded": []
  },
- "method": {
  - "rate": "current funding-period rate as published by the exchange (charged at next settlement; may change until then)",
  - "rate_8h": "rate × 8 / interval_h (rows with unknown interval excluded from aggregates)",
  - "apr_pct": "per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…",
  - "aggregate": "one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd",
  - "settled": "actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window",
  - "predicted_rate": "exchange-published indicative/next-period rate where available",
  - "liveness": "a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
  }
}

Mẫu đã xác minh

Ngoài ví dụ ở trên, trình thăm dò còn gọi endpoint này với các tham số dưới đây và kiểm tra schema ở mỗi lần gọi.

Tham số	HTTP	Độ trễ	Kết quả
coin=ETH	200	43 ms	Đạt
coin=SOL	200	44 ms	Đạt
coin=ARKM	200	41 ms	Đạt
—	400	1 ms	Đạt trả về lỗi như dự kiến

Kiểm tra lúc 2026-11-13 03:57:42 UTC

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ủ: 20s
Micro-cache biên: 10s
Tần suất cập nhật: mỗi 60 s với hầu hết các sàn (ghi cùng lúc với ticker; binance có tác vụ riêng chạy mỗi 60 s); các tác vụ funding còn lại và hợp đồng ký quỹ bằng coin mỗi 5 phút; bản ghi thanh toán mỗi giờ
Khung thời gian: ảnh chụp mới nhất (dòng funding trong vòng 4 h trên các hợp đồng có ticker / OI còn hoạt động); tổng đã thanh toán trong 7 ngày và 30 ngày
Nguồn dữ liệu: Tỷ lệ funding hiện tại do các trình thu thập của CoinBoss polling từ API REST công khai của 24 sàn hợp đồng vĩnh cửu (ví dụ binance, okx, bybit, bitget, gate, hyperliquid).
Độ phủ sàn: 24 sàn cho tỷ lệ hiện tại; lịch sử thanh toán từ 16 sàn (hợp đồng vĩnh cửu ký quỹ bằng coin của binance, okx, bybit được lưu riêng)
Đơn vị: unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
Phương pháp: one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
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
Có từ: 2026-11-11

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

Khả dụngKiểm tra lúc 2026-11-13 04:02:35 UTCHTTP 20036 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 36s

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

100% trong 411 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/sd/fundingKhả dụng

Tham số

coin Bắt buộc

string — Coin symbol; 400 when missing. Alias: `base`.

URL yêu cầuhttps://www.coinboss.com/api/sd/funding?coin=BTC

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.

Funding của một coin /api/sd/funding
Lịch sử funding trọng số theo OI / theo khối lượng /api/currency/funding-weighted
Chi tiết tỷ lệ funding theo từng sàn của một coin /api/derivatives/funding-detail
Funding tích lũy theo từng sàn của một coin /api/funding/accumulated
Cơ hội arbitrage funding /api/funding/arbitrage
Chuỗi biểu đồ tỷ lệ funding của một coin /api/funding/chart
Tỷ lệ funding hiện tại của một coin trên các sàn /api/funding/coin
Phí funding tích lũy /api/funding/fees
Heatmap tỷ lệ funding /api/funding/heatmap
Lịch sử tỷ lệ funding của một coin trên một sàn /api/funding/history
Ma trận tỷ lệ funding /api/funding/matrix
Danh sách tỷ lệ funding theo coin /api/market/funding
Xếp hạng chênh lệch tỷ lệ funding giữa các sàn /api/market/funding-spread