Chi tiết một ETF

Chi tiết một ETF (hồ sơ và lịch sử dòng tiền)

GET/api/etf/fund/:ticker

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ả
ticker path	string	Bắt buộc	—	—	Mã quỹ (chỉ gồm chữ cái, được chuyển thành chữ hoa); 404 nếu không xác định. Ví dụ: IBIT

Tham số được đánh dấu “path” là một phần của URL.

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/etf/fund/IBIT"

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 }`.
ticker	string	—	Ticker của quỹ.
asset	string	—	Ký hiệu tài sản.
issuer	string	—	Tổ chức phát hành quỹ.
price	object	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
price.currency	string	—	Ký hiệu tiền tệ / tài sản.
price.latest	object	—	Bản ghi gần nhất.
price.latest.date	string	—	Ngày theo lịch (UTC).
price.latest.close	number	—	Giá đóng cửa của kỳ.
price.latest.open	number	—	Giá mở cửa của kỳ.
price.latest.high	number	—	Giá cao nhất của kỳ.
price.latest.low	number	—	Giá thấp nhất của kỳ.
price.latest.volume	number	—	Khối lượng.
price.change_abs	number	USD	Giá đóng cửa ngày mới nhất của chứng chỉ quỹ trừ giá đóng cửa của ngày giao dịch trước đó.
price.change_pct	number	%	Thay đổi tính theo phần trăm.
price.week52_high	number	USD	Giá cao nhất theo ngày lớn nhất của chứng chỉ quỹ trong 365 ngày dương lịch tính đến ngày giá mới nhất.
price.week52_low	number	USD	Giá thấp nhất theo ngày nhỏ nhất của chứng chỉ quỹ trong 365 ngày dương lịch tính đến ngày giá mới nhất.
price.avg_volume_10d	number	shares	Khối lượng giao dịch trung bình ngày của quỹ trong 10 ngày giao dịch gần nhất, tính bằng số chứng chỉ quỹ.
price.count	number	—	Số mục.
price.data	array	—	Dữ liệu trả về.
price.data[]	object	—	Dữ liệu trả về.
price.data[].date	string	—	Ngày theo lịch (UTC).
price.data[].open	number	—	Giá mở cửa của kỳ.
price.data[].high	number	—	Giá cao nhất của kỳ.
price.data[].low	number	—	Giá thấp nhất của kỳ.
price.data[].close	number	—	Giá đóng cửa của kỳ.
price.data[].volume	number	—	Khối lượng.
fund	object	—	Các giá trị ảnh chụp ở cấp quỹ; mỗi giá trị là giá trị đã biết gần nhất và có thể thuộc các ngày khác nhau (xem `aum_as_of`).
fund.aum_usd_million	number	million USD	Tài sản quản lý khác null gần nhất của quỹ, có hiệu lực tại `aum_as_of`.
fund.aum_as_of	string	—	Ngày giao dịch (YYYY-MM-DD) mà `aum_usd_million` đề cập.
fund.estimated_holdings	number	coin	Số coin ước tính do quỹ nắm giữ: AUM đã biết gần nhất ÷ giá giao ngay hiện tại của tài sản; là ước tính, không phải lượng nắm giữ do tổ chức phát hành báo cáo.
fund.fee_pct	number	%	Phí quản lý hằng năm của quỹ tính bằng phần trăm (0.25 = 0.25 % mỗi năm); giá trị đã biết gần nhất từ một nguồn bên thứ ba.
fund.mkt_share_pct	number	%	AUM của quỹ tính theo phần trăm tổng vốn hóa của coin cơ sở (không phải thị phần của quỹ trong các ETF); giá trị đã biết gần nhất từ bên thứ ba.
fund.volume_usd_million	number	million USD	Khối lượng giao dịch của quỹ trong ngày gần nhất mà một nguồn bên thứ ba có báo cáo.
fund.cum_inflow_official_million	number	million USD	Dòng tiền vào ròng lũy kế từ khi ra mắt theo công bố của một nguồn bên thứ ba (giá trị đã biết gần nhất); có thể khác với tổng cộng dồn `flows.latest.cum_total`.
flows	object	—	Lịch sử dòng tiền ròng theo ngày của quỹ kèm tổng lũy kế; số tiền tính bằng triệu USD (`unit`).
flows.unit	string	—	Đơn vị của các giá trị trong object này.
flows.latest	object	—	Bản ghi gần nhất.
flows.latest.date	string	—	Ngày theo lịch (UTC).
flows.latest.flow	number	—	Dòng tiền phát hành / mua lại ròng trong ngày.
flows.latest.cum_total	number	—	Tổng lũy kế.
flows.latest.sum_7d	number	—	Tổng 7 ngày.
flows.count	number	—	Số mục.
flows.data	array	—	Dữ liệu trả về.
flows.data[]	object	—	Dữ liệu trả về.
flows.data[].date	string	—	Ngày theo lịch (UTC).
flows.data[].flow	number	—	Dòng tiền phát hành / mua lại ròng trong ngày.
flows.data[].cum	number	—	Dòng tiền ròng lũy kế từ khi niêm yết.
premium	object	—	Phần bù (+) hoặc chiết khấu (−) của giá thị trường so với NAV.
premium.unit	string	—	Đơn vị của các giá trị trong object này.
premium.note	string	—	Ghi chú.
premium.count	number	—	Số mục.
premium.data	array	—	Dữ liệu trả về.
premium.data[]	object	—	Dữ liệu trả về.
premium.data[].date	string	—	Ngày theo lịch (UTC).
premium.data[].premium	number	—	Phần bù (+) hoặc chiết khấu (−) của giá thị trường so với NAV.

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

Phản hồi mẫu

/api/etf/fund/IBIT · 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ị: flows.data có 712 phần tử; price.data có 713 phần tử; premium.data có 64 phần tử.

{
- "success": true,
- "ticker": "IBIT",
- "asset": "BTC",
- "issuer": "BlackRock",
- "price": {
  - "currency": "USD",
  - "latest": { … 6 },
  - "change_abs": -1.88,
  - "change_pct": -4.4508,
  - "week52_high": 59.56,
  - "week52_low": 32.84,
  - "avg_volume_10d": 52099530,
  - "count": 713,
  - "data": [ … 2 ]
  },
- "fund": {
  - "aum_usd_million": 62297.756,
  - "aum_as_of": "2026-11-11",
  - "estimated_holdings": 905689.4173,
  - "fee_pct": 0.25,
  - "mkt_share_pct": 3.995,
  - "volume_usd_million": 2604.817,
  - "cum_inflow_official_million": 65711.051
  },
- "flows": {
  - "unit": "million_usd",
  - "latest": { … 4 },
  - "count": 712,
  - "data": [ … 2 ]
  },
- "premium": {
  - "unit": "pct",
  - "note": "sparse_snapshot",
  - "count": 64,
  - "data": [ … 2 ]
  }
}

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: mỗi giờ (giá ở phút thứ 20, dòng tiền ở phút thứ 15); nến ngày
Khung thời gian: lịch sử giá và dòng tiền theo ngày đã lưu; giá cao nhất/thấp nhất 52 tuần và khối lượng trung bình 10 ngày
Nguồn dữ liệu: Dữ liệu trang của một quỹ: giá quỹ theo ngày từ một trang dữ liệu thị trường công khai, dòng tiền từ một trang theo dõi dòng tiền ETF công khai.
Độ phủ sàn: 36 ticker ETF giao ngay của Mỹ được theo dõi (ticker không xác định trả về 404).
Sắp xếp: ngày tăng dần
Đơn vị: USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
Phương pháp: estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
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ụngKiể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 28h

Độ 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/etf/fund/:tickerKhả dụng

Tham số

ticker Bắt buộc

string — Fund ticker (letters only, upper-cased); 404 if unknown.

URL yêu cầuhttps://www.coinboss.com/api/etf/fund/IBIT

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