Nhật ký thay đổi

Nhật ký thay đổi và phiên bản

Những gì đã thay đổi trong API, phiên bản hiện tại và các quy tắc tương thích.

v1Phiên bản hiện tại
2026.11.12Bản sửa đổi danh mục

Phiên bản và tương thích

Đánh số phiên bản

  • API công khai đang ở phiên bản v1. Tiền tố đường dẫn là `/api` và không mang số phiên bản.
  • Danh mục có phiên bản riêng theo ngày (`catalog_version`, ví dụ 2026.11.11). Phiên bản này thay đổi mỗi khi endpoint, tham số hoặc tài liệu thay đổi.
  • Mỗi phản hồi của các endpoint dữ liệu tự thu thập mang một id `schema` (ví dụ `sd.oi.v1`). Id mới chỉ được cấp khi một trường hiện có thay đổi ý nghĩa hoặc kiểu.

Tương thích

  • Việc thêm endpoint, tham số tùy chọn, trường phản hồi, giá trị enum hoặc sàn là thay đổi tương thích ngược và có thể diễn ra bất cứ lúc nào. Client phải bỏ qua những trường mà mình không biết.
  • Việc xóa hoặc đổi tên một trường, đổi kiểu hoặc đơn vị của nó, hoặc biến một tham số tùy chọn thành bắt buộc là thay đổi phá vỡ tương thích. Thay đổi này được thông báo tại đây trước khi phát hành.
  • Các hiệu chỉnh là ngoại lệ: bản sửa cho một con số sai, hoặc cho dữ liệu đầu vào không hợp lệ từng được chấp nhận một cách âm thầm, sẽ được phát hành ngay và được liệt kê tại đây vào ngày có hiệu lực, được đánh dấu là phá vỡ tương thích khi mã phía client có thể cần thay đổi.
  • Các con số có thể thay đổi vì độ phủ được cải thiện (thêm một sàn hoặc một loại hợp đồng mới). Độ phủ luôn được báo cáo trong phản hồi, vì vậy hãy so sánh `coverage` trước khi so sánh các tổng.
  • Dữ liệu thiếu được trả về là `null` và được liệt kê trong `coverage.unavailable`; nó không bao giờ bị thay bằng 0 hay một giá trị ước tính. Mã nào coi `null` là 0 sẽ cho kết quả sai.

Ngừng khuyến nghị

  • Các endpoint được đánh dấu `legacy` vẫn tiếp tục hoạt động, nhưng công việc mới nên dùng endpoint thay thế được nêu.
  • Một endpoint đời cũ chỉ bị gỡ bỏ sớm nhất là 90 ngày sau khi mục ngừng khuyến nghị của nó xuất hiện trong nhật ký thay đổi này.
  • Các endpoint được đánh dấu `beta` phục vụ các trang của website; tập trường của chúng có thể thay đổi mà không cần báo trước 90 ngày, nhưng mọi thay đổi vẫn được liệt kê tại đây.

Thay đổi

Thêm mới2026.11.12Tương thích ngược

`/api/currency/ex-table`: `market=perpetual`, `delivery` and `all`, plus one status vocabulary

  • New values of `market`: `perpetual` (perpetual contracts), `delivery` (dated futures) and `all` (spot, perpetual and delivery markets of the coin in one list). They return one row per market and number `rank` inside the requested view.
  • Every per-market row carries `market_status` (`ACTIVE`, `EXPIRING`, `EXPIRED`, `NO_QUOTE`, `STALE`), `reason_code` (`NO_QUOTE`, `EXPIRED`, `STALE`, `UNAVAILABLE` or null), `source_at`, `quality`, `is_stale`, `expires_in_s`, `symbol` and `base`. The state is derived from the contract specification of the exchange (expiry) and from the time the ticker was received. `status` and `status_reason` are unchanged.
  • `EXPIRING` marks a contract that still trades and expires within 24 hours (`meta.expiring_window_s`). Rows that are not `ACTIVE` or `EXPIRING` return `price: null`; no price is carried over from an earlier quote or from another contract.
  • `meta` adds `market_status_counts`, `type_counts` and `type_rankable`. The row order is the same for every caller: rankable rows by `volume_usd` descending, then rows without a quote, expired contracts last.
Thêm mới2026.11.12Tương thích ngược

`/api/liquidation-events` adds event / account counts and BTC high, low and range

  • New fields on every row: `btc_high`, `btc_low`, `btc_range` (USD, high − low) and `btc_range_pct` ((high − low) / low × 100), with `btc_range_meta`. Prices are the median of the UTC daily high / low on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD) spot. The fields are null unless all three venues have a final daily candle.
  • New fields on `coinboss` rows: `liquidation_count` (de-duplicated liquidation events; not people) and `account_count` (distinct liquidated accounts on exchanges that expose an account identifier, currently Hyperliquid only; `quality` is `PARTIAL`), each with a `_meta` object giving source, window, quality and coverage. Both are null on baseline rows.
  • CoinBoss does not publish a liquidated-trader (people) count; `coverage.metrics.people_count.quality` is `UNAVAILABLE`. `liquidated_traders` and `btc_amplitude` are unchanged: they stay the text recorded in the third-party source and are not copied into the new fields.
Thay đổi2026.11.12Tương thích ngược

`/api/currency/ex-table`: per-contract rows carry their own quote and a `status`

  • With `group=pair`, every contract row now uses the ticker of that contract. Before, only the main contract of each exchange had a price and the other rows returned `price: null`.
  • New row fields with `group=pair` and `market=spot`: `status` (`active`, `no_quote`, `not_provided`, `expired`), `status_reason`, `market_type`, `expiry_ts`, `expiry_date`, `native_symbol`, `quote`, `margin_type`, `price_source`, `price_at` and `rank`; the response adds `meta` (freshness window, volume window and unit, sort rule, row counts per status).
  • Rows that are not `active` return `price: null` and are never filled from another contract. `volume_usd` on such rows is `0` only when the exchange reports zero 24h turnover, otherwise `null`.
  • Order with `group=pair`: `active` rows first by `volume_usd` descending (these carry `rank`), then rows without a live quote by `oi_usd` descending, expired contracts last. `contract_type` now follows the exchange contract specification, so dated contracts on Deribit, Bybit, Gate and KuCoin are reported as `delivery`; `expiry` is set for all of them.
  • Requests without `group` return the same rows and fields as before.
Thay đổi2026.11.12Tương thích ngược

`/api/liquidation-events` returns the Top 10 with a `source` field

  • This corrects the 2026-11-11 entry below. The historical baseline rows (third-party public historical records) are served again, as recorded and without recalculation.
  • Rows recorded by CoinBoss are UTC daily totals from its own collectors. A day is added only when its total is greater than the 10th place of the list at that time. Every row carries `source` (`historical_baseline` or `coinboss`) and `basis`.
  • The list is sorted by `total_usd` and returns 10 rows. New fields: `data[].total_usd` (same value as `amount_usd`), `data[].source`, `data[].basis` and `threshold_usd`. `coverage` is split into `coverage.baseline` and `coverage.coinboss`; the `coverage.source`, `coverage.from` and `coverage.note` fields introduced on 2026-11-11 moved under them.
Thay đổi2026.11.12Tương thích ngược

Sự cố từ nguồn upstream trả về HTTP 503 và giữ nguyên nội dung lỗi JSON

  • Các yêu cầu thất bại trước đây trả về HTTP 502 hoặc 504 nay trả về 503 kèm header `Retry-After`. CDN đứng trước API từng thay nội dung của phản hồi 502 và 504 bằng văn bản riêng của nó, làm mất `code` và `request_id`; còn phản hồi 503 được chuyển qua nguyên vẹn. Các giá trị `code` vẫn như trước.
  • Một nguồn upstream gặp sự cố phía sau một endpoint không còn ảnh hưởng đến các endpoint khác: gateway chỉ thử lại trên instance khác khi gặp lỗi kết nối hoặc hết thời gian chờ.
  • `/api/sd/options/*` và `/api/sd/cme/overview` chấp nhận tên coin viết bằng chữ Hán. Coin không có thị trường tương ứng sẽ nhận HTTP 200 với các số liệu tổng hợp bằng `null` thay vì 400.
  • Lịch sử thanh toán funding: các khoảng trống trong khung 30 ngày được phát hiện và bổ sung cho 150 coin được giao dịch nhiều nhất trên Bybit, OKX, Gate và Bitget (40 coin trên HTX), nhờ đó `cum_7d` và `cum_30d` đầy đủ với nhiều coin hơn.
Sửa lỗi2026.11.11Tương thích ngược

Đã sửa chỉ số biến thiên thanh lý; endpoint có nguồn không khả dụng trả về 503

  • `/api/indicators/cdri`: chuỗi theo ngày bị rỗng vì bước gom nhóm theo ngày đã đọc dấu thời gian mili giây như thể là giây. Nay endpoint trả về tối đa 90 ngày UTC trọn vẹn của tổng thanh lý; `current.days` (trường mới) là số ngày được dùng, còn `current.cdri` / `current.liqCV` bằng `null` khi có ít hơn hai ngày.
  • `/api/indicators/reddit-subs`: trả về HTTP 503 kèm mã `UNAVAILABLE` trong lúc nguồn của nó từ chối yêu cầu, thay vì HTTP 500. Số người đăng ký chỉ được lưu khi nguồn trả về một số dương.
  • Body lỗi của các phản hồi HTTP 5xx không còn mang nội dung lỗi từ nguồn trong trường legacy `msg`; trường này nay chứa cùng thông báo chung như `error`.
Sửa lỗi2026.11.11Phá vỡ tương thích

Các bản ghi ngừng cập nhật được gắn cờ và loại khỏi các số tổng

  • `/api/coins/all` và `/api/coins/search`: bản ghi coin không được cập nhật quá 48 giờ sẽ trả về `market_cap` và `mcap_rank` là `null` kèm `is_stale: true`, và được xếp sau mọi dòng hiện hành. Quy tắc đang áp dụng được lặp lại trong `stale_rule`.
  • `/api/derivatives/coins-full`: đúng một dòng cho mỗi coin. Trước đây một ký hiệu dùng chung bởi nhiều bản ghi coin tạo ra một dòng cho mỗi bản ghi; nay dòng đó mang tên, vốn hóa và thứ hạng của bản ghi lớn nhất được cập nhật trong vòng 48 giờ, hoặc `null` khi không có bản ghi nào. `mcap_rank` là trường mới.
  • `/api/reserves/overview`: mọi dòng đều có `updated_at` và `is_stale`. `total` nay chỉ cộng các sàn được cập nhật trong vòng 36 giờ; định nghĩa trước đây được giữ lại dưới tên `total_including_stale`, và các sàn bị loại được liệt kê trong `stale_exchanges`.
  • `/api/margin/rates` và `/api/margin-fee/matrix`: các tài sản và ô có lãi suất ngừng cập nhật mang `is_stale: true`; các ngưỡng và số đếm được trả về ở cấp cao nhất.
  • Các ảnh chụp vốn hóa thị trường toàn cầu theo ngày từ 2026-10-28 đến 2026-11-11 đã được tính lại sau khi phát hiện trong tổng có hai bản ghi mang vốn hóa bất khả thi (lớn hơn Bitcoin). Các trình thu thập nay lưu `null` cho những giá trị như vậy.
Thay đổi2026.11.11Tương thích ngược

Sự cố nguồn được báo ngay trong phản hồi thay vì gây lỗi hoặc trông như dữ liệu hiện hành

  • `/api/indicators/mempool/pools`: khi nguồn mining pool không phản hồi, kết quả được lưu gần nhất sẽ được trả về kèm `stale: true`, `cached_at` và `stale_reason` thay vì HTTP 500.
  • `/api/etf/funds`: object `frozen_fields` mới nêu tên các trường cấp quỹ mà nguồn đã ngừng công bố từ 2026-10-08, kèm ngày mà mỗi giá trị phản ánh.
  • `/api/indicators/halving`: object `current_difficulty` mới (`value`, `as_of`, `source`). `difficulty` (tiến độ điều chỉnh độ khó) vẫn là `null` khi nguồn của nó không khả dụng.
  • `/api/browser/detect`: một lượt tra cứu chuỗi thất bại không còn bị báo là địa chỉ không có hoạt động. `kind` là `lookup_failed` khi không truy vấn được chuỗi nào.
  • `/api/currency/flows`: tài liệu nay liệt kê 22 khung thời gian mà endpoint thực sự cung cấp (từ 5 phút đến 1 năm).
Thay đổi2026.11.11Phá vỡ tương thích

Giá trị tham số không được hỗ trợ trả về 400 thay vì dữ liệu mặc định

  • `/api/derivatives/kline`: `interval=4h` trả về nến 4 giờ thực, dựng từ nến 1h theo các mốc UTC (trước đây trả về nến 1h). Mọi interval khác `1h`, `4h` hoặc `1d` đều trả về 400.
  • Các endpoint quyền chọn dưới `/api/options/`: `currency` không được hỗ trợ sẽ trả về 400 thay vì dữ liệu BTC, và `coin` được chấp nhận làm bí danh trên cả bảy endpoint.
  • `/api/etf/flows`, `/api/etf/detail`, `/api/etf/funds` và `/api/etf/holdings`: `asset` không được hỗ trợ sẽ trả về 400 thay vì dữ liệu BTC.
  • `/api/liquidations/coins`: `range` không được hỗ trợ sẽ trả về 400 thay vì dữ liệu 24h, và khung thời gian đang áp dụng được lặp lại trong `range`.
  • `limit` bị hạ xuống mức trần 1000 trên `/api/liquidations`, `/api/liquidations/largest` và `/api/derivatives/coins-full`. `limit` không phải số sẽ dùng giá trị mặc định thay vì gây lỗi.
Sửa lỗi2026.11.11Phá vỡ tương thích

Đã hiệu chỉnh khối lượng theo ngày và các thống kê nghiên cứu

  • `/api/volume/coin`: `daily_30d` trước đây cộng mọi ảnh chụp 24h trượt của một ngày và thổi phồng khối lượng ngày lên khoảng 24 lần. Nay trường này lấy ảnh chụp cuối cùng của mỗi ngày UTC.
  • `/api/research/stats` với `topic=derivatives`: `volume_24h_usd` cũng bị thổi phồng tương tự và đã được hiệu chỉnh.
  • `avg_funding_rate_pct` trong cùng phản hồi nay là giá trị phần trăm, gấp khoảng 100 lần giá trị số thập phân thô trả về trước đây. Hãy điều chỉnh mọi đoạn mã từng nhân trường này với 100.
Sửa lỗi2026.11.11Tương thích ngược

Các endpoint thị trường cũ bỏ qua những dòng đã ngừng cập nhật

  • Bị ảnh hưởng: `/api/market/tickers`, `/api/market/volume-rank`, `/api/market/open-interest`, `/api/market/funding`, `/api/market/funding-spread`, `/api/market/long-short`, `/api/market/long-short-v2`, `/api/market/overview`, `/api/p3/volume/overview`, `/api/p3/perp-spot-volume`, `/api/volume/btc-ex-share` và `/api/derivatives/coins-full`.
  • Các dòng chỉ được tính khi còn hiện hành: ticker trong vòng 1 giờ, vị thế mở trong vòng 3 giờ (CME: 120 giờ), funding trong vòng 4 giờ, tỷ lệ long/short trong vòng 24 giờ.
  • Các số tổng thấp hơn đôi chút và một số danh sách ngắn hơn. Các hợp đồng đã ngừng giao dịch hiển thị giá `null` thay vì giá trị cuối cùng của chúng.
Sửa lỗi2026.11.11Tương thích ngược

Hợp đồng hệ số nhân được khớp về coin cơ sở

  • `/api/funding/coin`, `/api/funding/history`, `/api/funding/chart` và `/api/ls/coin` nay khớp các hợp đồng được niêm yết giá theo bội số của một coin (ví dụ `1000PEPE`) về coin cơ sở, nên các coin này liệt kê được nhiều sàn hơn.
Thêm mới2026.11.11Tương thích ngược

Dữ liệu quyền chọn từ sáu sàn

  • Mới: `/api/sd/options/overview`, `/api/sd/options/expiries`, `/api/sd/options/strikes`, `/api/sd/options/chain` và `/api/sd/options/history`.
  • Vị thế mở, khối lượng danh nghĩa 24h, tỷ lệ put/call, max pain, IV ATM, skew 25-delta và cấu trúc kỳ hạn của IV do CoinBoss tính từ danh sách hợp đồng của Deribit, Binance, Bybit, OKX, Gate và Coincall.
  • Khối lượng danh nghĩa và doanh số phí quyền chọn là hai trường riêng và không bao giờ được cộng với nhau. Các cột mà một sàn không công bố là `null` và được liệt kê trong `coverage.field_gaps`.
  • Lịch sử có theo giờ và bắt đầu từ 2026-11-11; các giờ trước đó không được bổ sung.
Thêm mới2026.11.11Tương thích ngược

Dữ liệu ETF giao ngay, CME và CFTC từ các nguồn công bố gốc

  • Mới: `/api/sd/etf/overview`, `/api/sd/etf/funds` và `/api/sd/etf/history`, xây dựng từ công bố của tổ chức phát hành. Các tổng bao gồm những quỹ mà CoinBoss thu thập được; mọi quỹ khác được liệt kê kèm lý do, và `totals_scope` luôn là `covered_funds_only`.
  • Dòng tiền của quỹ do CoinBoss tính từ số chứng chỉ quỹ đang lưu hành và NAV (hoặc tài sản ròng và NAV). Công thức được dùng được trả về theo từng quỹ trong `flow_method`.
  • Mới: `/api/sd/cme/overview` (khối lượng và vị thế mở hằng ngày của tám sản phẩm CME) và `/api/sd/cme/cot` (vị thế CFTC hằng tuần theo nhóm nhà giao dịch).
  • Giá thanh toán của CME chưa được thu thập. Số liệu USD dùng một giá tham chiếu có ghi nhãn (`price_src`), và vì thế phần tổng quan được đánh dấu PARTIAL.
Thêm mới2026.11.11Tương thích ngược

Độ sâu sổ lệnh và trượt giá

  • Mới: `/api/sd/liquidity`, `/api/sd/liquidity/history` và `/api/sd/liquidity/rank`.
  • Độ sâu trong phạm vi ±0.5 %, ±1 % và ±2 % quanh giá giữa và trượt giá của lệnh thị trường 10k / 100k / 1M USD được tính từ ảnh chụp sổ lệnh thật của 24 sàn, riêng cho thị trường hợp đồng vĩnh cửu và thị trường giao ngay.
  • Ảnh chụp không chạm tới một dải sẽ được gắn cờ `complete: false`, được báo cáo như một cận dưới và bị loại khỏi số liệu tổng hợp. `n_included` cho biết một tổng gồm bao nhiêu sổ lệnh.
  • `/api/indicators/large-orderbook` là kết quả của một mô hình, không phải sổ lệnh; hãy dùng các endpoint mới để lấy thanh khoản đang chờ trên sổ lệnh.
Thêm mới2026.11.11Tương thích ngược

Basis từ giá đánh dấu và giá chỉ số của sàn

  • Mới: `/api/sd/basis`, `/api/sd/basis/history` và `/api/sd/basis/rank`.
  • Basis hợp đồng vĩnh cửu = (giá đánh dấu − giá chỉ số) ÷ giá chỉ số × 100 trên cùng một sàn; basis giao ngay - hợp đồng vĩnh cửu so sánh hợp đồng vĩnh cửu với thị trường giao ngay của cùng sàn đó; hợp đồng giao sau có kỳ hạn có thêm giá trị quy năm.
  • Số liệu tổng hợp được đưa ra theo trọng số OI, trọng số khối lượng và trung vị. Các dòng không đạt quy tắc đưa vào vẫn được trả về kèm `excluded_reason`.
  • Lịch sử theo giờ bắt đầu từ 2026-11-11.
Thay đổi2026.11.11Tương thích ngược

Các map icon dùng origin công khai của trang

  • `/api/coin-icons` và `/api/exchange-icons` trả về URL icon trên `https://www.coinboss.com`, cùng origin với mọi endpoint công khai khác. Các đường dẫn (`/api/coin-icon/{coin}`, `/api/exchange-icon/{exchange}`) không thay đổi.
Ngừng khuyến nghị2026.11.11Tương thích ngược

`/api/basis/list` và `/api/cftc/cot` được đánh dấu legacy

  • Hãy dùng `/api/sd/basis/rank` thay cho `/api/basis/list`, và `/api/sd/cme/cot` thay cho `/api/cftc/cot`. Các endpoint đời cũ vẫn tiếp tục hoạt động.
Thay đổi2026.11.11Tương thích ngược

`/api/liquidation-events` giờ chỉ phục vụ bản ghi của CoinBoss

  • Danh sách được dựng từ các lệnh thanh lý mà CoinBoss nhận từ feed của sàn. Lịch sử của nó bắt đầu từ 2026-08-19; các ngày trước đó không trả về dòng nào.
  • Tên và kiểu của các trường không thay đổi.
Gỡ bỏ2026.11.11Tương thích ngược

Các endpoint vận hành không còn truy cập được từ internet

  • `/api/health/alerts`, `/api/health/server`, `/api/health/history` và `/api/health/ch-read` trả về 404 với các yêu cầu công khai. Chúng chưa bao giờ thuộc API công khai.
  • Hãy dùng `/api/meta/status` để xem trạng thái dịch vụ và `/api/meta/quality` để xem độ mới của dữ liệu.
Thêm mới2026.11.11Tương thích ngược

Trung tâm nhà phát triển và metadata API cho máy đọc

  • Mới: `/api/meta/catalog`, `/api/meta/endpoint`, `/api/meta/status`, `/api/meta/quality`, `/api/meta/changelog` và `/api/meta/openapi`.
  • Bảng trường và phản hồi mẫu trong tài liệu được sinh ra từ phản hồi thật bởi một trình thăm dò API gọi mọi endpoint công khai mỗi 5 phút.
  • Trạng thái endpoint (available / partial / degraded / down / unavailable) giờ lấy từ chính các lệnh gọi thật đó, không phải từ trạng thái tiến trình.
Thay đổi2026.11.11Tương thích ngược

Nội dung lỗi thống nhất và ID yêu cầu

  • Mọi phản hồi đều mang header `X-Request-Id`; nội dung lỗi lặp lại giá trị này dưới tên `request_id`.
  • Nội dung lỗi giờ là `{ success: false, code, error, request_id }` trên mọi endpoint. `error` vẫn là một chuỗi, nên các client hiện có tiếp tục hoạt động.
  • Các route `/api/*` không xác định trả về JSON 404 (`NOT_FOUND`) thay vì một trang HTML.
  • Phản hồi HTTP 429 có kèm `Retry-After`.
  • Thông báo của lỗi 5xx được viết chung chung; chi tiết nội bộ không còn bị lộ ra trong phản hồi.
Thêm mới2026.11.11Tương thích ngược

Các endpoint dữ liệu tự thu thập có độ phủ và chất lượng trong mọi phản hồi

  • Mới: `/api/sd/oi`, `/api/sd/funding`, `/api/sd/liquidations`, `/api/sd/volume`, `/api/sd/ls`, `/api/sd/coin` và `/api/sd/quality`.
  • Vị thế mở được báo cáo riêng cho hợp đồng USDT / USDC / ký quỹ bằng coin / giao sau có kỳ hạn, và nêu rõ những sàn nào báo cáo số liệu hai chiều.
  • Funding được trả về ở dạng thô, kèm chu kỳ, dạng chuẩn hóa về 8h và dạng quy năm; những sàn có hợp đồng không còn hoạt động bị loại và được liệt kê.
Ngừng khuyến nghị2026.11.11Tương thích ngược

`/api/market/long-short` được đánh dấu legacy

  • Hãy dùng `/api/market/long-short-v2` cho dạng danh sách hoặc `/api/sd/ls` để lấy các tỷ lệ theo tài khoản / vị thế / taker của từng sàn.
Thay đổi2026.10.31Tương thích ngược

Các trường icon trả về đường dẫn cùng nguồn gốc

  • Các trường như `image_url` / `icon` giờ chứa một đường dẫn của CoinBoss (`/api/coin-icon/...`) thay vì URL của bên thứ ba.
  • Coin không có icon đã xác minh trả về `null`; client nên tự hiển thị hình giữ chỗ của riêng mình.
Sửa lỗi2026.10.24Tương thích ngược

Các dòng quá hạn không còn được đưa vào số liệu tổng hợp

  • Các tổng của vị thế mở, funding và long/short chỉ dùng những dòng được cập nhật trong khung dữ liệu mới (khung này dài hơn với CME, vốn công bố hằng ngày).
  • Hợp đồng đã hủy niêm yết ngừng đóng góp vào các tổng khi lần cập nhật cuối của chúng ra khỏi khung.

Endpoint đời cũ

Được giữ lại để tương thích. Chúng vẫn hoạt động; các tích hợp mới nên dùng endpoint thay thế.

EndpointThay thếMô tả
/api/market/long-short/api/market/long-short-v2Được giữ lại cho các tích hợp hiện có. Hãy dùng `/api/market/long-short-v2` (bổ sung bộ lọc sàn) hoặc `/api/sd/ls` (theo từng sàn, tách riêng tài khoản / vị thế / taker).
/api/basis/list/api/sd/basis/rank`apr_pct` bằng `basis_pct × 3 × 365`, một phép ngoại suy đơn giản từ basis hợp đồng vĩnh cửu hiện tại như thể nó được trả mỗi 8 giờ; đây không phải lợi suất funding hay lợi suất của hợp đồng giao sau có kỳ hạn. `/api/sd/basis` báo cáo riêng basis giá đánh dấu so với giá chỉ số, basis hợp đồng vĩnh cửu so với giao ngay và basis hợp đồng giao sau có kỳ hạn.