Tổng quan quyền chọn (mọi sàn)
Vị thế mở quyền chọn, khối lượng 24h, các tỷ lệ put/call, max pain, biến động ngụ ý ATM, skew 25-delta và cấu trúc kỳ hạn IV của một coin, tổng hợp trên sáu sàn kèm phần tách theo từng sàn.
/api/sd/options/overviewYê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, không phân biệt chữ hoa chữ thường (ví dụ `BTC`). Giá trị bị thiếu hoặc sai định dạng trả về 400. Ví dụ: BTC |
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/sd/options/overview?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 }`. |
| schema | string | — | ID schema của phản hồi này. Nó chỉ thay đổi khi một trường hiện có đổi ý nghĩa hoặc kiểu dữ liệu. |
| now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| coin | string | — | Ký hiệu coin (chữ hoa). |
| index_price | number|null | USD | Giá chỉ số giao ngay dùng để quy đổi sang USD (trong số liệu tổng hợp là trung vị các giá chỉ số của chính các sàn). |
| n_contracts | number|null | — | Số hợp đồng quyền chọn được tính. |
| oi_usd | number|null | USD | Vị thế mở theo giá trị danh nghĩa USD: số lượng coin × giá chỉ số giao ngay. Một chiều. |
| call_oi_usd | number|null | USD | Vị thế mở call, giá trị danh nghĩa USD. |
| put_oi_usd | number|null | USD | Vị thế mở put, giá trị danh nghĩa USD. |
| oi_coin | number|null | coin | Vị thế mở tính bằng đơn vị coin cơ sở. |
| call_oi_coin | number|null | coin | Vị thế mở call tính bằng đơn vị coin cơ sở. |
| put_oi_coin | number|null | coin | Vị thế mở put tính bằng đơn vị coin cơ sở. |
| vol_usd_24h | number|null | USD | Khối lượng danh nghĩa 24h: số lượng coin giao dịch × giá chỉ số giao ngay hiện tại. Không phải doanh số phí quyền chọn. |
| call_vol_usd_24h | number|null | USD | Khối lượng danh nghĩa 24h của call. |
| put_vol_usd_24h | number|null | USD | Khối lượng danh nghĩa 24h của put. |
| vol_coin_24h | number|null | coin | Số lượng giao dịch 24h tính bằng đơn vị coin cơ sở. |
| call_vol_coin_24h | number|null | coin | Số lượng giao dịch 24h của call, tính bằng coin. |
| put_vol_coin_24h | number|null | coin | Số lượng giao dịch 24h của put, tính bằng coin. |
| vol_premium_usd_24h | number|null | USD | Doanh số phí quyền chọn 24h (giá quyền chọn × số lượng) ở những sàn có công bố; `null` ở các sàn khác. Không bao giờ được cộng vào khối lượng danh nghĩa. |
| pcr_oi | number|null | ratio | Vị thế mở put ÷ vị thế mở call, tính theo đơn vị coin; `null` khi phía call bằng 0. |
| pcr_vol | number|null | ratio | Khối lượng 24h của put ÷ khối lượng 24h của call, tính theo đơn vị coin; `null` khi phía call bằng 0. |
| n_expiries | number|null | — | Số ngày đáo hạn được tính. |
| vol_exchanges | array | — | Các sàn đóng góp vào khối lượng danh nghĩa. |
| vol_exchanges[] | string | — | Các sàn đóng góp vào khối lượng danh nghĩa. |
| vol_premium_exchanges | array | — | Các sàn có công bố doanh số phí quyền chọn. |
| vol_premium_exchanges[] | string | — | Các sàn có công bố doanh số phí quyền chọn. |
| max_pain_nearest | object|null | — | Max pain của ngày đáo hạn gần nhất có vị thế mở. |
| max_pain_nearest.expiry | string | — | Ngày đáo hạn (UTC), `YYYY-MM-DD`, hoặc `all`. |
| max_pain_nearest.days_left | number | days | Số ngày đến đáo hạn. |
| max_pain_nearest.strike | number | USD | Giá thực hiện. |
| max_pain_nearest.pain_usd | number | USD | Tổng khoản chi trả cho người nắm giữ quyền chọn nếu kỳ đáo hạn được thanh toán tại giá thực hiện này. |
| max_pain_nearest.oi_usd | number | USD | Vị thế mở theo giá trị danh nghĩa USD: số lượng coin × giá chỉ số giao ngay. Một chiều. |
| max_pain_nearest.exchanges | array | — | Các sàn được tính trong dòng này. |
| max_pain_nearest.exchanges[] | string | — | Các sàn được tính trong dòng này. |
| max_pain_main | object|null | — | Max pain của ngày đáo hạn chính: ngày đáo hạn gần nhất chiếm ít nhất 5 % tổng vị thế mở. |
| max_pain_main.expiry | string | — | Ngày đáo hạn (UTC), `YYYY-MM-DD`, hoặc `all`. |
| max_pain_main.days_left | number | days | Số ngày đến đáo hạn. |
| max_pain_main.strike | number | USD | Giá thực hiện. |
| max_pain_main.pain_usd | number | USD | Tổng khoản chi trả cho người nắm giữ quyền chọn nếu kỳ đáo hạn được thanh toán tại giá thực hiện này. |
| max_pain_main.oi_usd | number | USD | Vị thế mở theo giá trị danh nghĩa USD: số lượng coin × giá chỉ số giao ngay. Một chiều. |
| max_pain_main.exchanges | array | — | Các sàn được tính trong dòng này. |
| max_pain_main.exchanges[] | string | — | Các sàn được tính trong dòng này. |
| atm_iv_nearest | number|null | % | IV ATM của ngày đáo hạn gần nhất. |
| atm_iv_main | number|null | % | IV ATM của ngày đáo hạn chính. |
| atm_iv_30d | number|null | % | IV ATM được nội suy tuyến tính về kỳ hạn cố định 30 ngày; `null` khi mốc 30 ngày không nằm giữa hai ngày đáo hạn. |
| skew_25d_main | number|null | percentage points | Skew 25-delta của ngày đáo hạn chính. |
| term_structure | array | — | IV ATM theo từng ngày đáo hạn, gần nhất trước. |
| term_structure[] | object | — | IV ATM theo từng ngày đáo hạn, gần nhất trước. |
| term_structure[].expiry | string | — | Ngày đáo hạn (UTC), `YYYY-MM-DD`, hoặc `all`. |
| term_structure[].days_left | number | days | Số ngày đến đáo hạn. |
| term_structure[].atm_iv | number | % | Biến động ngụ ý ATM (at-the-money): trung bình IV theo giá đánh dấu tại giá thực hiện gần giá forward nhất. |
| term_structure[].oi_usd | number | USD | Vị thế mở theo giá trị danh nghĩa USD: số lượng coin × giá chỉ số giao ngay. Một chiều. |
| exchanges | array | — | Các sàn được tính trong dòng này. |
| exchanges[] | object | — | Các sàn được tính trong dòng này. |
| exchanges[].exchange | string | — | ID sàn (viết thường). |
| exchanges[].oi_share_pct | number | % | Tỷ trọng trong tổng vị thế mở (giá trị danh nghĩa USD) của phạm vi đã chọn. |
| exchanges[].n_contracts | number | — | Số hợp đồng quyền chọn được tính. |
| exchanges[].oi_usd | number | USD | Vị thế mở theo giá trị danh nghĩa USD: số lượng coin × giá chỉ số giao ngay. Một chiều. |
| exchanges[].call_oi_usd | number | USD | Vị thế mở call, giá trị danh nghĩa USD. |
| exchanges[].put_oi_usd | number | USD | Vị thế mở put, giá trị danh nghĩa USD. |
| exchanges[].oi_coin | number | coin | Vị thế mở tính bằng đơn vị coin cơ sở. |
| exchanges[].call_oi_coin | number | coin | Vị thế mở call tính bằng đơn vị coin cơ sở. |
| exchanges[].put_oi_coin | number | coin | Vị thế mở put tính bằng đơn vị coin cơ sở. |
| exchanges[].vol_usd_24h | number | USD | Khối lượng danh nghĩa 24h: số lượng coin giao dịch × giá chỉ số giao ngay hiện tại. Không phải doanh số phí quyền chọn. |
| exchanges[].call_vol_usd_24h | number | USD | Khối lượng danh nghĩa 24h của call. |
| exchanges[].put_vol_usd_24h | number | USD | Khối lượng danh nghĩa 24h của put. |
| exchanges[].vol_coin_24h | number | coin | Số lượng giao dịch 24h tính bằng đơn vị coin cơ sở. |
| exchanges[].call_vol_coin_24h | number | coin | Số lượng giao dịch 24h của call, tính bằng coin. |
| exchanges[].put_vol_coin_24h | number | coin | Số lượng giao dịch 24h của put, tính bằng coin. |
| exchanges[].vol_premium_usd_24h | number|null | USD | Doanh số phí quyền chọn 24h (giá quyền chọn × số lượng) ở những sàn có công bố; `null` ở các sàn khác. Không bao giờ được cộng vào khối lượng danh nghĩa. |
| exchanges[].pcr_oi | number | ratio | Vị thế mở put ÷ vị thế mở call, tính theo đơn vị coin; `null` khi phía call bằng 0. |
| exchanges[].pcr_vol | number | ratio | Khối lượng 24h của put ÷ khối lượng 24h của call, tính theo đơn vị coin; `null` khi phía call bằng 0. |
| exchanges[].n_expiries | number | — | Số ngày đáo hạn được tính. |
| exchanges[].oi_usd_inverse | number|null | USD | Vị thế mở của các hợp đồng thanh toán bằng coin. |
| exchanges[].oi_usd_linear | number | USD | Vị thế mở của các hợp đồng thanh toán bằng stablecoin. |
| exchanges[].oi_usd_reported | number|null | USD | Con số vị thế mở tính bằng USD của chính sàn, ở những sàn có công bố. Chỉ dùng để đối chiếu. |
| exchanges[].vol_usd_reported_24h | number|null | USD | Con số giá trị giao dịch danh nghĩa của chính sàn, ở những sàn có công bố. Chỉ dùng để đối chiếu. |
| exchanges[].index_price | number | USD | Giá chỉ số giao ngay dùng để quy đổi sang USD (trong số liệu tổng hợp là trung vị các giá chỉ số của chính các sàn). |
| exchanges[].received_at | number | ms | Thời điểm trình thu thập của CoinBoss nhận được dữ liệu. |
| exchanges[].observed_at | number|null | ms | Dấu thời gian do nguồn cung cấp cho dữ liệu. |
| exchanges[].age_s | number | s | Số giây kể từ khi dòng được nhận. |
| exchanges[].is_stale | boolean | — | True khi dữ liệu cũ hơn khung dữ liệu mới của nó. |
| coverage | object | — | Những gì được tính và không được tính trong các con số. 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.included_exchanges | array | — | Các nguồn có dữ liệu còn mới được tính. |
| coverage.included_exchanges[] | string | — | Các nguồn có dữ liệu còn mới được tính. |
| coverage.unavailable | array | — | Các nguồn không thể đưa vào, mỗi nguồn kèm một lý do. Chúng không bao giờ bị tính là 0. |
| coverage.unavailable[] | object | — | Các nguồn không thể đưa vào, mỗi nguồn kèm một lý do. Chúng không bao giờ bị tính là 0. |
| coverage.unavailable[].exchange | string | — | ID sàn (viết thường). |
| coverage.unavailable[].reason | string | — | Mã lý do máy đọc được. |
| coverage.unavailable[].detail | string | — | Giải thích lý do cho người đọc. |
| coverage.stale_excluded | array | — | Các dòng bị loại vì lần cập nhật gần nhất nằm ngoài khung dữ liệu mới. rỗng trong các mẫu dùng để tạo bảng này |
| coverage.field_gaps | array | — | Các cột mà một sàn không công bố; chúng là `null` với sàn đó. |
| coverage.field_gaps[] | object | — | Các cột mà một sàn không công bố; chúng là `null` với sàn đó. |
| coverage.field_gaps[].exchange | string | — | ID sàn (viết thường). |
| coverage.field_gaps[].fields | array | — | Tên các cột bị thiếu. |
| coverage.field_gaps[].fields[] | string | — | Tên các cột bị thiếu. |
| coverage.field_gaps[].kind | string | — | Nhóm hợp đồng: `inverse` (thanh toán bằng coin) hoặc `linear` (thanh toán bằng stablecoin). |
| 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, mỗi trường một mục. |
| method.oi_usd | string | — | Ghi chú công thức cho `oi_usd`, dạng văn bản thuần. |
| method.vol_usd_24h | string | — | Ghi chú công thức cho `vol_usd_24h`, dạng văn bản thuần. |
| method.vol_premium_usd_24h | string | — | Ghi chú công thức cho `vol_premium_usd_24h`, dạng văn bản thuần. |
| method.pcr_oi | string | — | Ghi chú công thức cho `pcr_oi`, dạng văn bản thuần. |
| method.pcr_vol | string | — | Ghi chú công thức cho `pcr_vol`, dạng văn bản thuần. |
| method.max_pain | string | — | Ghi chú công thức cho `max_pain`, dạng văn bản thuần. |
| method.atm_iv | string | — | Ghi chú công thức cho `atm_iv`, dạng văn bản thuần. |
| method.atm_iv_30d | string | — | Ghi chú công thức cho `atm_iv_30d`, dạng văn bản thuần. |
| method.skew_25d | string | — | Ghi chú công thức cho `skew_25d`, dạng văn bản thuần. |
| method.oi_share_pct | string | — | Ghi chú công thức cho `oi_share_pct`, dạng văn bản thuần. |
| method.index_price | string | — | Ghi chú công thức cho `index_price`, dạng văn bản thuần. |
| method.max_pain_main | string | — | Ghi chú công thức cho `max_pain_main`, dạng văn bản thuần. |
| method.oi_usd_reported | string | — | Ghi chú công thức cho `oi_usd_reported`, dạng văn bản thuần. có thể vắng mặt |
| method.vol_usd_reported_24h | string | — | Ghi chú công thức cho `vol_usd_reported_24h`, dạng văn bản thuần. có thể vắng mặt |
| meta | object | — | Nguồn gốc dữ liệu và độ mới của phản hồi này. |
| meta.schema | string | — | ID schema của phản hồi này. Nó chỉ thay đổi khi một trường hiện có đổi ý nghĩa hoặc kiểu dữ liệu. |
| meta.source | array | — | Các endpoint công khai của nguồn (upstream) mà dữ liệu được thu thập từ đó. |
| meta.source[] | object | — | Các endpoint công khai của nguồn (upstream) mà dữ liệu được thu thập từ đó. |
| meta.source[].exchange | string | — | ID sàn (viết thường). |
| meta.source[].endpoint | string | — | Endpoint công khai của nguồn mà trình thu thập đọc (hiển thị để nêu nguồn gốc dữ liệu; client không bao giờ gọi endpoint này). |
| meta.observed_at | number|null | ms | Dấu thời gian do nguồn cung cấp cho dữ liệu. |
| meta.received_at | number|null | ms | Thời điểm trình thu thập của CoinBoss nhận được dữ liệu. |
| meta.fetched_at | number | ms | Thời điểm phản hồi này được dựng. |
| meta.window | string | — | Khung thời gian mà các con số bao phủ. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN hoặc UNAVAILABLE, đánh giá từ dấu thời gian của dữ liệu và độ phủ. |
| meta.is_stale | boolean | — | True khi dữ liệu cũ hơn khung dữ liệu mới của nó. |
| meta.cache_ttl_s | number | s | Thời gian sống trong cache của phản hồi này. |
| meta.fallback | string | — | Endpoint trả về gì khi trình thu thập hoặc một nguồn gặp lỗi. |
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/options/overview?coin=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 03:58:21 UTC. Mảng và map dài được rút gọn khi hiển thị: exchanges có 6 phần tử; meta.source có 6 phần tử; term_structure có 12 phần tử; coverage.field_gaps có 4 phần tử; coverage.unavailable có 12 phần tử; coverage.stale_included có 6 phần tử.
- "success"true
- "schema""coinboss.sd.options/1"
- "now"1794542301260
- "coin""BTC"
- "index_price"71498.15576087
- "n_contracts"5792
- "oi_usd"32670143083.84
- "call_oi_usd"18276964561.96
- "put_oi_usd"14393178521.88
- "oi_coin"457419.65
- "call_oi_coin"255899.54
- "put_oi_coin"201520.11
- "vol_usd_24h"4295495191.7
- "call_vol_usd_24h"2031780368.24
- "put_vol_usd_24h"2263714823.46
- "vol_coin_24h"60122.56
- "call_vol_coin_24h"28436.77
- "put_vol_coin_24h"31685.79
- "vol_premium_usd_24h"34033631.12
- "pcr_oi"0.7875
- "pcr_vol"1.1143
- "n_expiries"12
- "vol_exchanges"
- "binance"
- "bybit"
- "coincall"
- "deribit"
- "gate"
- "okx"
- "vol_premium_exchanges"
- "binance"
- "deribit"
- "gate"
- "max_pain_nearest"
- "expiry""2026-11-13"
- "days_left"0.1678
- "strike"75000
- "pain_usd"15831410
- "oi_usd"3892192707.39
- "exchanges"
- "max_pain_main"
- "expiry""2026-11-13"
- "days_left"0.1678
- "strike"75000
- "pain_usd"15831410
- "oi_usd"3892192707.39
- "exchanges"
- "atm_iv_nearest"40.28
- "atm_iv_main"40.28
- "atm_iv_30d"37.2
- "skew_25d_main"6.6
- "term_structure"
- "exchanges"
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "field_gaps"
- "stale_included"
- "method"
- "oi_usd""sum over contracts of oi_coin x that exchange's spot index price (USDT/USDC treated 1:1 as USD); oi_coin is open interest in units of the underlying coin after …"
- "vol_usd_24h""NOTIONAL 24h volume = sum of vol_coin (24h traded quantity in underlying coin) x the exchange's CURRENT spot index price; not premium turnover. Binance statisti…"
- "vol_premium_usd_24h""PREMIUM turnover (option price x quantity) as reported by the exchange: Deribit volume_usd, Binance amount, Gate sum(|size| x multiplier x price) from the 24h t…"
- "pcr_oi""put open interest / call open interest, both in underlying-coin units; null when call side is 0 or missing"
- "pcr_vol""put 24h volume / call 24h volume, both in underlying-coin units; null when call side is 0 or missing"
- "max_pain""per expiry: settlement price S among strikes with OI>0 minimizing pain_usd(S) = sum_calls oi_coin x max(S-K,0) + sum_puts oi_coin x max(K-S,0); ties take the lo…"
- "atm_iv""per exchange and expiry: reference price F = median of the exchange-published forward/underlying price of that expiry (the exchange index price where no forward…"
- "atm_iv_30d""30-day constant-maturity ATM IV: linear interpolation in days between the two expiries bracketing 30 days; null when 30 days is not bracketed"
- "skew_25d""IV(put with delta closest to -0.25, within +-0.10) - IV(call with delta closest to +0.25, within +-0.10), in percentage points, using exchange-published deltas …"
- "oi_share_pct""exchange oi_usd / sum of oi_usd over included exchanges x 100"
- "index_price""median of the included exchanges' own spot index prices"
- "max_pain_main""main expiry = nearest expiry holding >=5% of total OI notional (same rule as legacy /api/options/overview); max_pain_nearest = nearest listed expiry with OI"
- "oi_usd_reported""sum of the exchange's own USD figure where it publishes one (Binance sumOpenInterestUsd, OKX oiUsd), for cross-checking only; null elsewhere"
- "vol_usd_reported_24h""exchange-reported notional turnover where published (Bybit turnover24h), for cross-checking only; null elsewhere"
- "meta"
- "schema""coinboss.sd.options/1"
- "source"
- "observed_at"1794522472654
- "received_at"1794522473814
- "fetched_at"1794542301260
- "window""latest"
- "quality""STALE"
- "is_stale"true
- "cache_ttl_s"60
- "fallback""on collector failure the last stored rows are served: an exchange whose newest batch is older than 25 min (collector cycle is 10 min) is excluded from totals (l…"
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 | 66 ms | Đạt STALE |
| coin=SOL | 200 | 22 ms | Đạt STALE |
| coin=PEPE | 200 | 2 ms | Đạt UNAVAILABLE |
| — | 400 | 1 ms | Đạt trả về lỗi như dự kiến |
Kiểm tra lúc 2026-11-13 03:28:18 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ủ
- 60s
- Micro-cache biên
- 10s
- Tần suất cập nhật
- Trình thu thập chạy một vòng mỗi 10 phút; một sàn được coi là còn mới trong 25 phút sau vòng thành công gần nhất.
- Khung thời gian
- Ảnh chụp mới nhất; các trường khối lượng bao phủ 24 giờ gần nhất, theo số liệu từng sàn báo cáo.
- Nguồn dữ liệu
- Các endpoint quyền chọn REST công khai của Deribit, Binance, Bybit, OKX, Gate và Coincall, do CoinBoss thu thập và lưu trữ (sd_opt_latest, sd_opt_summary_hourly). Không dùng nhà tổng hợp bên thứ ba nào.
- Độ phủ sàn
- Sáu sàn quyền chọn. Coin không có quyền chọn niêm yết trên các sàn đã chọn trả về HTTP 200 với các trường null, `meta.quality = "UNAVAILABLE"` và lý do trong `coverage.unavailable`. Các sàn không có feed quyền chọn công khai cũng được liệt kê ở đó.
- Đơn vị
- USD notional = contracts × contract size × spot index price of the venue. `*_coin` fields are in units of the underlying coin. Implied volatility is in percent (55 = 55 %). `vol_premium_usd_24h` is premium turnover, reported separately and never added to notional volume.
- Phương pháp
- pcr_oi = put OI ÷ call OI (coin units). Max pain = the strike that minimises the total intrinsic value paid to option holders at expiry. ATM IV = mean mark IV of the contracts at the strike closest to the forward price published by the venue for that expiry; `atm_iv_30d` is interpolated linearly between the two expiries that bracket 30 days. skew_25d = IV(put with delta closest to −0.25) − IV(call with delta closest to +0.25), in percentage points, using deltas published by the venues only.
- 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
Endpoint báo cáo chất lượng dữ liệu STALE
Độ khả dụng, 30 ngày qua
100% trong 407 lần kiểm tra đạt
- Được trả về nhưng chưa có trong tài liệu: coverage.stale_included, coverage.stale_included[], coverage.stale_included[].exchange, coverage.stale_included[].age_s
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ử
/api/sd/options/overviewSuy giảmstring — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.
https://www.coinboss.com/api/sd/options/overview?coin=BTCEndpoint khác trong danh mục này
- Chuỗi quyền chọn (một sàn) /api/sd/options/chain
- Quyền chọn theo ngày đáo hạn /api/sd/options/expiries
- Lịch sử quyền chọn (theo giờ) /api/sd/options/history
- Tổng quan quyền chọn (mọi sàn) /api/sd/options/overview
- Quyền chọn theo giá thực hiện /api/sd/options/strikes
- Tóm tắt quyền chọn trên trang coin /api/currency/options-summary
- Đường cong smile / cấu trúc kỳ hạn của biến động ngụ ý quyền chọn /api/options/iv
- Lịch sử biến động ngụ ý quyền chọn /api/options/iv-history
- Max pain quyền chọn /api/options/max-pain
- OI quyền chọn theo ngày đáo hạn /api/options/oi-by-expiry
- OI quyền chọn theo giá thực hiện /api/options/oi-by-strike
- Tổng quan quyền chọn /api/options/overview
- Phân bổ khối lượng quyền chọn /api/options/volume-dist