GETKhả dụng
Sản phẩm ETF / quỹ tín thác của một tổ chức phát hành
Sản phẩm ETF / quỹ tín thác của một tổ chức phát hành
GET
/api/etf/issuerYê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ả |
|---|---|---|---|---|---|
| issuer | string | Tùy chọn | Grayscale | — | Tên tổ chức phát hành (tối đa 64 ký tự). Ví dụ: Grayscale |
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/etf/issuer?issuer=Grayscale"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 }`. |
| issuer | string | — | Tổ chức phát hành quỹ. |
| unit | string | — | Đơn vị của các giá trị trong object này. |
| products | array | — | Các sản phẩm ETF của tổ chức phát hành kèm toàn bộ lịch sử dòng tiền; sản phẩm BTC xếp trước, sau đó theo mã quỹ. |
| products[] | object | — | Một sản phẩm: `ticker`, `asset` cơ sở, `count` số dòng, tóm tắt `latest` và `data` theo ngày. |
| products[].ticker | string | — | Ticker của quỹ. |
| products[].asset | string | — | Ký hiệu tài sản. |
| products[].count | number | — | Số mục. |
| products[].latest | object | — | Bản ghi gần nhất. |
| products[].latest.date | string | — | Ngày theo lịch (UTC). |
| products[].latest.flow | number | — | Dòng tiền phát hành / mua lại ròng trong ngày. |
| products[].latest.cum_total | number | — | Tổng lũy kế. |
| products[].latest.aum | number|null | — | Tài sản đang quản lý (AUM). |
| products[].latest.aum_date | string|null | — | Ngày giao dịch (YYYY-MM-DD) của dòng mà `latest.aum` được lấy từ đó; có thể cũ hơn `latest.date`, null khi không có AUM nào. |
| products[].latest.sum_7d | number | — | Tổng 7 ngày. |
| products[].data | array | — | Dữ liệu trả về. |
| products[].data[] | object | — | Dữ liệu trả về. |
| products[].data[].date | string | — | Ngày theo lịch (UTC). |
| products[].data[].flow | number | — | Dòng tiền phát hành / mua lại ròng trong ngày. |
| products[].data[].aum | number|null | — | Tài sản đang quản lý (AUM). |
| products[].data[].premium | number|null | — | Phần bù (+) hoặc chiết khấu (−) của giá thị trường so với NAV. |
| products[].data[].cum | number | — | Dòng tiền ròng lũy kế từ khi niêm yết. |
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/issuer?issuer=Grayscale · Phản hồi thật, ghi lại lúc 2026-11-13 04:02:52 UTC. Mảng và map dài được rút gọn khi hiển thị: products có 6 phần tử; products[].data có 713 phần tử.
- "success"true
- "issuer""Grayscale"
- "unit""million_usd"
- "products"
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ờ (phút thứ 15); nguồn công bố một lần mỗi ngày giao dịch của Mỹ
- Khung thời gian
- toàn bộ lịch sử của từng sản phẩm
- Nguồn dữ liệu
- Lịch sử dòng tiền theo từng sản phẩm của một tổ chức phát hành ETF, lấy từ một trang theo dõi dòng tiền ETF công khai; AUM lấy từ một trang dữ liệu thị trường công khai.
- Độ phủ sàn
- Các sản phẩm của tổ chức phát hành được chỉ định (mặc định Grayscale) cho BTC/ETH/SOL/HYPE; tên tổ chức phát hành phải khớp chính xác với nhãn đã lưu.
- Sắp xếp
- sản phẩm: BTC xếp trước, sau đó theo ticker; dữ liệu theo ngày tăng dần
- Đơn vị
- million USD (flow, cum, aum); premium in percent
- Phương pháp
- cum is the running sum of daily flows per product; sum_7d sums the last 7 trading days.
- 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:52 UTCHTTP 2002 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/issuerKhả dụngTham số
string · mặc định Grayscale — Issuer name (max 64 chars).
URL yêu cầu
https://www.coinboss.com/api/etf/issuer?issuer=GrayscaleChọ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.
Endpoint khác trong danh mục 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