Dòng nạp / rút của vault Hyperliquid
Dòng nạp / rút của vault Hyperliquid
/api/hl/vault-flowsYê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ả |
|---|---|---|---|---|---|
| addr | string | Bắt buộc | — | — | Địa chỉ 40 ký tự hex có tiền tố 0x; 400 khi sai định dạng. Ví dụ: 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303 |
| limit | integer | Tùy chọn | 100 | ≤ 500 | Số dòng trả về. Ví dụ: 100 |
| min_usd | number | Tùy chọn | — | — | Giá trị danh nghĩa tối thiểu (USD). |
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/hl/vault-flows?addr=0xdfc24b077bc1425ad1dea75bcb6f8158e10df303&limit=100"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 }`. |
| updated | number | ms | Thời điểm dữ liệu được cập nhật lần gần nhất. |
| h24 | object | — | Giá trị 24 giờ. |
| h24.depositUsd | number | USD | Lượng nạp trong 24 giờ qua, của vault được yêu cầu hoặc của mọi vault khi bỏ trống `addr`. |
| h24.withdrawUsd | number | USD | Lượng rút trong 24 giờ qua, cùng phạm vi với `depositUsd`. |
| h24.netUsd | number | USD | `depositUsd` − `withdrawUsd`. |
| h24.count | number | — | Số mục. |
| rows | array | — | Các dòng kết quả. |
| rows[] | object | — | Các dòng kết quả. |
| rows[].address | string | — | Địa chỉ on-chain. |
| rows[].name | string | — | Tên. |
| rows[].isDeposit | boolean | — | True với một lần nạp vào vault, false với một lần rút. |
| rows[].usd | number | USD | Giá trị. |
| rows[].ts | number | ms | Dấu thời gian. |
| rows[].tvl | number | USD | Tổng giá trị bị khóa trong vault. |
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/hl/vault-flows?addr=0xdfc24b077bc1425ad1dea75bcb6f8158e10df303&limit=100 · Phản hồi thật, ghi lại lúc 2026-11-13 03:58:38 UTC. Mảng và map dài được rút gọn khi hiển thị: rows có 100 phần tử.
- "success"true
- "updated"1794542318643
- "h24"
- "depositUsd"970086.66
- "withdrawUsd"135154.69
- "netUsd"834931.97
- "count"137
- "rows"
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ủ
- 15s
- Micro-cache biên
- 10s
- Tần suất cập nhật
- mỗi 10 s; cache API 15 s
- Khung thời gian
- danh sách sự kiện từ 2026-07-18; h24 = 24h trượt
- Nguồn dữ liệu
- Các sự kiện nạp và rút của vault, đọc từ node Hyperliquid do CoinBoss tự vận hành, kèm tóm tắt dòng tiền ròng 24h.
- Độ phủ sàn
- Mọi vault Hyperliquid
- Phân trang
- limit (mặc định 100, tối đa 500); bộ lọc addr (tùy chọn), min_usd
- Sắp xếp
- ts giảm dần
- Đơn vị
- USD
- Phương pháp
- h24.netUsd = SUM(deposits) - SUM(withdrawals) over the last 24h
- 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
100% trong 409 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/hl/vault-flowsKhả dụngstring — 0x-prefixed 40-hex address; 400 on bad format.
integer · mặc định 100 · tối đa 500 — Number of rows to return.
number — Minimum notional (USD).
https://www.coinboss.com/api/hl/vault-flows?addr=0xdfc24b077bc1425ad1dea75bcb6f8158e10df303&limit=100Endpoint khác trong danh mục này
- Trạng thái tài khoản Hyperliquid của một địa chỉ /api/hl/address/:addr
- Dữ liệu trang vị thế cá voi Hyperliquid theo coin /api/hl/coin
- Tổng quan đốt HYPE /api/hl/hype-burn
- Thống kê đốt HYPE /api/hl/hype-burn-stats
- Giao dịch đốt / mua lại HYPE /api/hl/hype-burn-txs
- Nhãn địa chỉ Hyperliquid /api/hl/labels/:addr
- Phân bổ quy mô vị thế trên Hyperliquid /api/hl/margin-distribution
- Danh sách thị trường hợp đồng vĩnh cửu Hyperliquid /api/hl/markets
- Phân bổ PnL của ví Hyperliquid /api/hl/pnl-distribution
- Tóm tắt vị thế Hyperliquid /api/hl/position-summary
- Bảng xếp hạng smart money Hyperliquid /api/hl/smart-money
- Heatmap bậc × coin của Hyperliquid /api/hl/symbol-heatmap
- Chi tiết một bậc Hyperliquid /api/hl/tier/:slug
- Các địa chỉ trong một bậc Hyperliquid /api/hl/tier/:slug/addresses
- Lệnh khớp của vault Hyperliquid /api/hl/vault-fills
- Dòng nạp / rút của vault Hyperliquid /api/hl/vault-flows
- Hồ sơ vault Hyperliquid /api/hl/vault-profile/:addr
- Chi tiết vault Hyperliquid /api/hl/vault/:addr
- Danh sách vault Hyperliquid /api/hl/vaults
- Bảng tổng quan vault Hyperliquid /api/hl/vaults/overview
- Hoạt động mở / đóng vị thế của cá voi Hyperliquid /api/hl/whale-actions
- Chi tiết một cá voi Hyperliquid /api/hl/whale/:addr
- Danh sách vị thế cá voi Hyperliquid /api/hl/whales
- Phân bổ long/short của cá voi Hyperliquid /api/hl/whales/long-short
- Thống kê nhóm cá voi Hyperliquid /api/hl/whales/stats