OI quyền chọn theo giá thực hiện
OI quyền chọn theo giá thực hiện
/api/options/oi-by-strikeYê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ả |
|---|---|---|---|---|---|
| currency | string | Tùy chọn | BTC | BTC, ETH | Tài sản cơ sở: `BTC` hoặc `ETH`. Mọi giá trị khác trả về 400 `INVALID_PARAM`. Bí danh: `coin`. Ví dụ: BTC |
| expiry | string | Tùy chọn | all | — | Ngày đáo hạn; all = mọi ngày đáo hạn. |
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/options/oi-by-strike?currency=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 }`. |
| currency | string | — | Ký hiệu tiền tệ / tài sản. |
| expiry | string | — | Ngày đáo hạn của loạt quyền chọn. |
| index_price | number | — | Giá chỉ số của tài sản cơ sở. |
| snap_ts | number | ms | Thời điểm của ảnh chụp. |
| expiries | array | — | Các ngày đáo hạn của quyền chọn / hợp đồng tương lai. |
| expiries[] | string | — | Các ngày đáo hạn của quyền chọn / hợp đồng tương lai. |
| count | number | — | Số mục. |
| data | array | — | Dữ liệu trả về. |
| data[] | object | — | Dữ liệu trả về. |
| data[].strike | number | USD | Giá thực hiện. |
| data[].call_oi | number | coin | Vị thế mở của quyền chọn call Deribit tại giá thực hiện này, cộng trên các ngày đáo hạn được chọn, tính bằng đơn vị coin cơ sở. |
| data[].put_oi | number | coin | Vị thế mở của quyền chọn put Deribit tại giá thực hiện này, cộng trên các ngày đáo hạn được chọn, tính bằng đơn vị coin cơ sở. |
| data[].call_oi_usd | number | USD | Vị thế mở của call. |
| data[].put_oi_usd | number | USD | Vị thế mở của put. |
Tạo lúc 2026-11-11 23:00 UTC từ 2 phản hồi thật.
Phản hồi mẫu
/api/options/oi-by-strike?currency=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 03:58:24 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 87 phần tử; expiries có 12 phần tử.
- "success"true
- "currency""BTC"
- "expiry""all"
- "index_price"69009.96
- "snap_ts"1794541801732
- "expiries"
- "2026-11-13"
- "2026-11-14"
- "2026-11-15"
- "2026-11-16"
- "2026-11-20"
- "2026-11-27"
- "2026-12-04"
- "2026-12-25"
- "count"87
- "data"
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ả |
|---|---|---|---|
| currency=ETH | 200 | 4 ms | Đạt |
| currency=SOL | 400 | 1 ms | Đạt trả về lỗi như dự kiến |
Kiểm tra lúc 2026-11-13 03:58:24 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ủ
- 2m
- Micro-cache biên
- 10s
- Tần suất cập nhật
- mỗi 10 phút (thay toàn bộ ảnh chụp)
- Khung thời gian
- ảnh chụp mới nhất
- Nguồn dữ liệu
- Vị thế mở quyền chọn theo giá thực hiện, lấy từ API công khai của một sàn duy nhất (Deribit).
- Độ phủ sàn
- Chỉ Deribit, quyền chọn BTC và ETH; các sàn khác (quyền chọn Binance/OKX/Bybit, CME) không được tính. Chỉ các giá thực hiện có vị thế mở > 0.
- Sắp xếp
- giá thực hiện tăng dần
- Đơn vị
- coins and USD notional
- Phương pháp
- Call and put open interest summed per strike, for one expiry or all expiries.
- 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ụng, 30 ngày qua
99.76% 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ử
/api/options/oi-by-strikeKhả dụngstring · mặc định BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.
string · mặc định all — Expiry; all = every expiry.
https://www.coinboss.com/api/options/oi-by-strike?currency=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