GETKhả dụng
Báo giá hợp đồng Pre-IPO
Báo giá hợp đồng Pre-IPO
GET
/api/preipo/listYêu cầu
Endpoint này không nhận tham số nào.
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/preipo/list"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 }`. |
| now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| source | string | — | Giá trị này đến từ đâu. |
| totals | object | — | Các tổng. |
| totals.volume_24h | number | — | Khối lượng 24h. |
| totals.underlyings | number | — | Ký hiệu các tài sản cơ sở. |
| totals.contracts | number | — | Các dòng theo từng hợp đồng. |
| totals.exchanges | number | — | Các sàn. |
| count | number | — | Số mục. |
| data | array | — | Dữ liệu trả về. |
| data[] | object | — | Dữ liệu trả về. |
| data[].underlying | string | — | Ký hiệu cổ phiếu / chỉ số / hàng hóa cơ sở. |
| data[].name | string | — | Tên. |
| data[].type | string | — | Loại. |
| data[].exchanges | number | — | Các sàn. |
| data[].volume_24h | number | — | Khối lượng 24h. |
| data[].oi_usd | number | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
| data[].price_avg | number | — | Giá trung bình trên các sàn. |
| data[].change_24h | number | — | Thay đổi 24h. |
| data[].price_min | number | USD | Giá gần nhất thấp nhất trong các sàn niêm yết hợp đồng pre-IPO này (bỏ qua ticker cũ hơn 12 giờ); null khi không sàn nào có giá. |
| data[].price_max | number | USD | Giá gần nhất cao nhất trong các sàn niêm yết hợp đồng pre-IPO này (bỏ qua ticker cũ hơn 12 giờ); null khi không sàn nào có giá. |
| data[].markets | array | — | Các thị trường. |
| data[].markets[] | object | — | Các thị trường. |
| data[].markets[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| data[].markets[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| data[].markets[].price | number | — | Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác). |
| data[].markets[].change_pct | number|null | % | Thay đổi tính theo phần trăm. |
| data[].markets[].volume_24h | number | — | Khối lượng 24h. |
| data[].markets[].funding | number | — | Khối hoặc giá trị tỷ lệ funding. |
| data[].markets[].oi_usd | number|null | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
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/preipo/list · Phản hồi thật, ghi lại lúc 2026-11-13 03:58:45 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 3 phần tử; data[].markets có 13 phần tử.
- "success"true
- "now"1794542325199
- "source""in-house collection"
- "totals"
- "volume_24h"2217092315.81
- "underlyings"3
- "contracts"43
- "exchanges"18
- "count"3
- "data"
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ủ
- 60s
- Micro-cache biên
- 10s
- Tần suất cập nhật
- sổ đăng ký hợp đồng mỗi 24 h; ticker mỗi 1 phút; cache API 60 s
- Khung thời gian
- 24h
- Nguồn dữ liệu
- Hợp đồng vĩnh cửu Pre-IPO (tổng hợp) niêm yết trên các sàn crypto, tổng hợp theo từng tài sản cơ sở từ ticker công khai của sàn.
- Độ phủ sàn
- 3 tài sản cơ sở / 43 hợp đồng trên 18 sàn tại thời điểm thăm dò
- Phân trang
- không có
- Sắp xếp
- volume_24h giảm dần
- Đơn vị
- USD; change in percent
- Phương pháp
- price and change are volume-weighted across exchanges; price_min / price_max show cross-exchange dispersion
- 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 03:58:45 UTCHTTP 2004 msSchema khớ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ử
GET
/api/preipo/listKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/preipo/listChọ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
- Tổng quan thanh lý hợp đồng vĩnh cửu TradFi /api/liquidations/tradfi
- Danh sách ký hiệu TradFi có thanh lý trong khung thời gian /api/liquidations/tradfi-asset-list
- Xếp hạng thanh lý theo ký hiệu của hợp đồng vĩnh cửu TradFi /api/liquidations/tradfi-assets
- Phân bổ thanh lý theo sàn của hợp đồng vĩnh cửu TradFi /api/liquidations/tradfi-exchanges
- Feed thanh lý hợp đồng vĩnh cửu TradFi /api/liquidations/tradfi-feed
- Các lệnh thanh lý lớn nhất trên hợp đồng vĩnh cửu TradFi /api/liquidations/tradfi-largest
- Tổng thanh lý hợp đồng vĩnh cửu TradFi theo nhiều khung thời gian /api/liquidations/tradfi-overview
- Tổng quan thanh lý của một ký hiệu TradFi /api/liquidations/tradfi-symbol
- Chuỗi thời gian thanh lý của một ký hiệu TradFi /api/liquidations/tradfi-symbol-chart
- Phân bổ thanh lý theo sàn của một ký hiệu TradFi /api/liquidations/tradfi-symbol-exchanges
- Các lệnh thanh lý lớn nhất của một ký hiệu TradFi /api/liquidations/tradfi-symbol-largest
- Các ký hiệu TradFi có lịch sử thanh lý /api/liquidations/tradfi-symbols
- Bảng thanh lý TradFi /api/liquidations/tradfi-table
- Chuỗi thời gian tổng thanh lý hợp đồng vĩnh cửu TradFi /api/liquidations/tradfi-total-chart
- Báo giá hợp đồng Pre-IPO /api/preipo/list
- Danh sách tài sản cơ sở cổ phiếu /api/stock-detail-list
- Chi tiết tài sản cơ sở cổ phiếu /api/stock-detail/:underlying
- Danh sách công cụ cổ phiếu /api/stocks/list
- Hợp đồng vĩnh cửu cổ phiếu / cổ phiếu token hóa niêm yết trên các sàn /api/tabs17/exchange-stocks
- Báo giá cổ phiếu liên quan đến crypto /api/tabs17/stocks