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/etf/history

GETMột phầnPARTIAL

Lịch sử ETF giao ngay

Chuỗi theo ngày của lượng nắm giữ, tài sản ròng hoặc dòng tiền ròng cho một tài sản (cộng các quỹ được phủ) hoặc cho một quỹ riêng lẻ. Mỗi điểm nêu rõ nó gồm bao nhiêu quỹ.

GET/api/sd/etf/history

Độ phủ một phần. Độ phủ một phần: một số tổ chức phát hành lớn không cung cấp bản công bố công khai ở dạng máy đọc được mà máy chủ có thể thu thập. Các quỹ của họ được liệt kê là không khả dụng, và các tổng chỉ gồm những quỹ còn lại. Hãy so sánh `funds_covered` / `funds_total` trước khi so sánh tổng với các nguồn khác.

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ả
asset	string	Bắt buộc	—	BTC, ETH, SOL, HYPE	Tài sản cơ sở, không phân biệt chữ hoa chữ thường. `coin` được chấp nhận làm bí danh. Ví dụ: BTC
metric	string	Bắt buộc	—	holdings, aum, flow	Chuỗi cần trả về: lượng nắm giữ (coin), tài sản ròng (USD) hoặc dòng tiền ròng (USD). Ví dụ: flow
range	string	Tùy chọn	30d	30d, 90d, all	Khoảng nhìn lại.
ticker	string	Tùy chọn	—	—	Ticker của quỹ đã đăng ký cho tài sản (ví dụ `ARKB`). Mặc định: cộng mọi quỹ được phủ. Ticker chưa đăng ký trả về 404; quỹ đã đăng ký nhưng không thu thập được trả về 200 với `series: null`.

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/sd/etf/history?asset=BTC&metric=flow"

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.
asset	string	—	Tài sản cơ sở.
metric	string	—	Chuỗi được chọn qua tham số `metric`.
range	string	—	Khoảng nhìn lại đã áp dụng.
ticker	string\|null	—	Ticker của quỹ.
unit	string	—	Đơn vị của các giá trị trong chuỗi: `coin` hoặc `USD`.
funds_total	number	—	Các quỹ đã đăng ký cho tài sản.
funds_in_series	array	—	Các quỹ đóng góp vào chuỗi.
funds_in_series[]	string	—	Các quỹ đóng góp vào chuỗi.
first_date_by_fund	object	—	Ngày đầu tiên có dữ liệu của từng quỹ (khóa là ticker). khóa động: ARKB,EZBC
first_date_by_fund.{*}	string	—	Ngày đầu tiên có dữ liệu của từng quỹ (khóa là ticker).
points	number	—	Các điểm của chuỗi, cũ nhất trước.
series	array	—	Các điểm theo ngày, cũ nhất trước; `null` khi không thu thập được quỹ.
series[]	object	—	Các điểm theo ngày, cũ nhất trước; `null` khi không thu thập được quỹ.
series[].date	string	—	Ngày chốt số liệu của tổ chức phát hành cho điểm này.
series[].value	number	—	Giá trị của chỉ số đã chọn, cộng trên các quỹ có mặt vào ngày đó.
series[].funds	number	—	Mỗi quỹ đã đăng ký một dòng, kể cả các quỹ không thu thập được. 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ố. 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[].issuer	string	—	ID tổ chức phát hành quỹ.
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
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.value	string	—	Ghi chú công thức cho `value`, dạng văn bản thuần.
method.funds	string	—	Ghi chú công thức cho `funds`, dạng văn bản thuần.
method.multi_day	string	—	Ghi chú công thức cho `multi_day`, dạng văn bản thuần.
method.history_start	string	—	Ghi chú công thức cho `history_start`, dạng văn bản thuần.
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	ms	Dấu thời gian do nguồn cung cấp cho dữ liệu.
meta.received_at	number	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ừ 3 phản hồi thật.

Phản hồi mẫu

/api/sd/etf/history?asset=BTC&metric=flow · Phản hồi thật, ghi lại lúc 2026-11-13 04:02:51 UTC. Mảng và map dài được rút gọn khi hiển thị: series có 21 phần tử; meta.source có 5 phần tử; first_date_by_fund có 5 phần tử; coverage.unavailable có 7 phần tử.

{
- "success": true,
- "schema": "coinboss.sd.etf/1",
- "now": 1794542297946,
- "asset": "BTC",
- "metric": "flow",
- "range": "30d",
- "ticker": null,
- "unit": "USD",
- "funds_total": 12,
- "funds_in_series": [
  - "ARKB",
  - "BITB",
  - "BTCO",
  - "EZBC",
  - "HODL"
  ],
- "first_date_by_fund": {
  - "ARKB": "2026-10-14",
  - "BITB": "2026-11-11"
  },
- "points": 21,
- "series": [
  - { … 3 },
  - { … 3 }
  ],
- "coverage": {
  - "included_exchanges": [ … 5 ],
  - "unavailable": [ … 2 ],
  - "stale_excluded": []
  },
- "method": {
  - "value": "own method, per fund between two consecutive issuer as-of rows: shares_x_nav = (shares_out[t] - shares_out[t-1]) x NAV[t], dated t; aum_nav_ratio_t1 (issuer pub…",
  - "funds": "number of funds contributing to that date; the aggregate is only comparable across dates with the same contributing funds (history starts on different dates per…",
  - "multi_day": "true when a contributing flow spans more than one trading day because the issuer history has no row for the day(s) in between",
  - "history_start": "issuer-provided official history is back-filled where it exists (21Shares valuation history, Franklin price history); other issuers start on the first collectio…"
  },
- "meta": {
  - "schema": "coinboss.sd.etf/1",
  - "source": [ … 2 ],
  - "observed_at": 1794441600000,
  - "received_at": 1794537318126,
  - "fetched_at": 1794542297946,
  - "window": "30d",
  - "quality": "PARTIAL",
  - "is_stale": false,
  - "cache_ttl_s": 300,
  - "fallback": "collector failure keeps the last issuer row with its real as_of_date; a fund whose as_of_date is more than 1 trading day behind the expected as-of is flagged is…"
  }
}

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ả
asset=ETH&range=90d&metric=aum	200	5 ms	Đạt PARTIAL
asset=BTC&metric=holdings&ticker=ARKB	200	4 ms	Đạt FRESH
asset=BTC	400	1 ms	Đạt trả về lỗi như dự kiến

Kiểm tra lúc 2026-11-13 03:58:17 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ủ: 5m
Micro-cache biên: 10s
Tần suất cập nhật: Trình thu thập chạy ba vòng mỗi ngày (02:35, 10:35, 16:35 UTC). Tổ chức phát hành công bố một lần mỗi ngày giao dịch của Mỹ, thường vào buổi tối của ngày giao dịch.
Khung thời gian: 30d / 90d / all, mỗi ngày chốt số liệu của tổ chức phát hành một điểm.
Nguồn dữ liệu: Các bản công bố hằng ngày do chính tổ chức phát hành quỹ đăng tải (lượng nắm giữ, tài sản ròng, số chứng chỉ quỹ đang lưu hành, NAV), do CoinBoss thu thập và lưu trữ (sd_etf_fund_daily). Dòng tiền ròng do CoinBoss tính từ các bản công bố đó.
Độ phủ sàn: Chỉ phủ những quỹ có tổ chức phát hành công bố dữ liệu hằng ngày ở dạng máy đọc được. `funds_total` và `funds_covered` cho biết số lượng; mọi quỹ không được phủ đều được liệt kê trong `coverage.unavailable` kèm lý do. Các tổng chỉ cộng trên những quỹ được phủ (`totals_scope = "covered_funds_only"`), không phải toàn thị trường.
Phân trang: Không phân trang; `range` quyết định số điểm.
Sắp xếp: Ngày tăng dần.
Đơn vị: Amounts in USD; holdings in units of the underlying coin; NAV and market price in USD per share; `premium_pct` and `fee_pct` in percent.
Phương pháp: A point sums the funds that have a row on that date; `funds` is that count. Points with different `funds` are not directly comparable. Flow is bucketed by its booking date.
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

Một phầnKiểm tra lúc 2026-11-13 04:02:51 UTCHTTP 2001 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 88m

Endpoint báo cáo chất lượng dữ liệu PARTIAL — Độ phủ một phần: một số tổ chức phát hành lớn không cung cấp bản công bố công khai ở dạng máy đọc được mà máy chủ có thể thu thập. Các quỹ của họ được liệt kê là không khả dụng, và các tổng chỉ gồm những quỹ còn lại. Hãy so sánh `funds_covered` / `funds_total` trước khi so sánh tổng với các nguồn khác.

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

100% 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/sd/etf/historyMột phần

Tham số

asset Bắt buộc

string — Underlying asset, case-insensitive. `coin` is accepted as an alias.

metric Bắt buộc

string — Series to return: holdings (coin), net assets (USD) or net flow (USD).

range

string · mặc định 30d — Look-back range.

ticker

string — Fund ticker registered for the asset (for example `ARKB`). Default: all covered funds summed. An unregistered ticker returns 404; a registered fund that cannot be collected returns 200 with `series: null`.

URL yêu cầuhttps://www.coinboss.com/api/sd/etf/history?asset=BTC&metric=flow

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.

Các quỹ ETF giao ngay /api/sd/etf/funds
Lịch sử ETF giao ngay /api/sd/etf/history
Tổng quan ETF giao ngay (công bố của tổ chức phát hành) /api/sd/etf/overview
Dòng tiền ròng hằng ngày của ETF giao ngay theo từng quỹ /api/etf/detail
Lịch sử dòng tiền ròng hằng ngày của ETF giao ngay /api/etf/flows
Chi tiết một ETF /api/etf/fund/:ticker
Danh sách quỹ ETF /api/etf/funds
Lượng coin nắm giữ của ETF theo từng quỹ /api/etf/holdings
Sản phẩm ETF / quỹ tín thác của một tổ chức phát hành /api/etf/issuer
Tổng quan ETF /api/etf/overview
Phần bù / chiết khấu của quỹ tín thác Grayscale /api/grayscale/premium
Khối lượng ETF dựa trên hợp đồng tương lai /api/indicators/futures-etf-volumes