Smart Money API
Một API trí tuệ chuyên nghiệp tổng hợp dữ liệu phái sinh, số liệu on-chain và hoạt động ví cá voi thành một điểm tin cậy duy nhất cho bot giao dịch của bạn.
https://api.smartmoneyapi.com/v1Nguyên tắc thiết kế
Bốn ý tưởng định hình mọi endpoint và mọi điểm số mà API này trả về. Chúng cũng là ranh giới trung thực về những gì nó hứa hẹn — và không hứa hẹn.
Chiến lược trước, tín hiệu sau. Đây không phải là nguồn cấp tín hiệu mua/bán. Bạn mang đến chiến lược và điểm vào lệnh; API cho bạn biết liệu cấu trúc thị trường xung quanh — vị thế phái sinh, funding, open interest, thanh khoản, dòng chảy on-chain và sự đồng thuận của cá voi — có đồng ý với giao dịch bạn muốn thực hiện hay không.
Điểm tin cậy, không phải dự đoán nhị phân. Mọi câu trả lời đều mang theo mức độ confidence (CAO / TRUNG BÌNH / THẤP) và một composite từ -1.0 đến +1.0. Không có gì đảm bảo và không có lời tiên tri — bạn nhận được một đánh giá được hiệu chỉnh về sự đồng thuận, cùng với lý do đằng sau nó, để bạn có thể điều chỉnh quy mô theo mức độ tin tưởng.
Hỗ trợ quyết định, không phải lời khuyên thực thi. API trả về một khuyến nghị CONFIRM / REDUCE / SKIP và hệ số nhân kích thước cho logic của bạn để hành động. Nó không bao giờ đặt lệnh, và không có gì ở đây là lời khuyên tài chính. Bạn vẫn chịu trách nhiệm về rủi ro, quy mô và thực thi.
Số liệu sống, không phải đảm bảo cố định. Tỷ lệ thắng, thống kê chế độ và số liệu chính xác được tính từ mẫu lăn và thay đổi khi thị trường thay đổi. Chúng tôi công bố chúng một cách trung thực, kể cả khi chúng ở mức trung bình. Hãy coi mọi số liệu là một quan sát hiện tại, không phải lời hứa về tương lai.
API này dành cho ai
API này được xây dựng cho các nhà phát triển bot, thuật toán và AI-agent tiền điện tử những người đã có tín hiệu dài/ngắn — từ chiến lược TA, mô hình ML, pipeline Freqtrade, cảnh báo TradingView hoặc agent LLM — và muốn một quyết định CONFIRM / REDUCE / SKIP nhanh chóng trước khi cam kết vốn.
Một vòng lặp điển hình: chiến lược của bạn kích hoạt "mua dài BTC" → bạn gọi GET /v1/confirm?symbol=BTC&direction=long → bạn xác nhận, giảm hoặc bỏ qua điểm vào và điều chỉnh quy mô theo size_mult. Một lệnh gọi, phản hồi JSON độ trễ thấp duy nhất, không cần thêm cơ sở hạ tầng.
Nó không phải là một bộ tạo tín hiệu độc lập, sản phẩm biểu đồ hoặc nơi thực thi. Nếu bạn không có tín hiệu riêng để kiểm soát, hãy bắt đầu với trang hiệu suất để xem điểm số đã hoạt động như thế nào trước khi tích hợp vào bot live.
Cách truy cập
1 — Đăng ký. Tạo tài khoản miễn phí tại signup (email/mật khẩu hoặc Google). Không cần thẻ tín dụng cho bản miễn phí.
2 — Mở bảng điều khiển của bạn. Bảng điều khiển của bạn hiển thị khóa API, gói hiện tại và mức sử dụng trực tiếp so với hạn ngạch hàng ngày.
3 — Sao chép khóa API của bạn. Khóa được bắt đầu bằng sm_. Truyền nó dưới dạng X-API-Key tiêu đề trên mọi yêu cầu (xem Xác thực). Nâng cấp bất cứ lúc nào trên trang giá để nâng giới hạn và mở khóa thêm biểu tượng và điểm cuối.
Tài liệu kỹ thuật, SDK & Sách công thức
Mọi thứ bạn cần để tích hợp nhanh chóng, dù bạn tự viết code hay giao cho một agent lập trình.
| Tài nguyên | Nó là gì |
|---|---|
| Sách công thức | Các công thức copy-paste cho những tích hợp phổ biến nhất — xác nhận trước khi vào lệnh, kiểm soát tín hiệu Freqtrade, định cỡ theo hệ số nhân, xử lý lỗi 402/429, và kết nối với agent lập trình. |
| OpenAPI spec | Định nghĩa OpenAPI có thể đọc bằng máy của mọi điểm cuối. Nhập vào Postman/Insomnia, tạo client, hoặc cung cấp cho LLM. Tại github.com/tashiardit/smartmoneyapi-docs. |
| Python client | Thư viện client Python chính thức tại github.com/tashiardit/smartmoneyapi-python. |
| /llms.txt | Bản tóm tắt API dạng văn bản thuần thân thiện với LLM. Hướng Claude, Codex hoặc Cursor vào nó (xem Agent lập trình). |
Bắt đầu nhanh trong 2 phút
Bước 1 — URL cơ sở. Mọi điểm cuối đều nằm dưới:
Bước 2 — Lấy API key của bạn. Đăng ký miễn phí (không cần thẻ tín dụng) và sao chép key từ bảng điều khiển. Truyền nó như X-API-Key header trong mọi yêu cầu.
Bước 3 — Lệnh gọi đầu tiên. Dán lệnh này vào terminal và thay thế sm_your_key bằng key từ bảng điều khiển của bạn:
Phản hồi mong đợi:
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM",
"size_mult": 1.5,
"deriv_score": 0.81,
"onchain_score": 0.68,
"whale_score": 0.73,
"reasons": ["Funding rate positive across all venues", "Whales: 67% long consensus"]
}
Khi confidence là HIGH hoặc MEDIUM và action là CONFIRM, điều chỉnh kích thước vị thế theo size_mult. Đó là toàn bộ vòng lặp tích hợp. Xem Các trường phản hồi để tra cứu đầy đủ các trường.
Xác thực
Mọi yêu cầu đều cần API key được truyền qua X-API-Key HTTP header.
API key của bạn có sẵn tại bảng điều khiển sau khi đăng ký. Giữ key bí mật — không để lộ trong code phía client hoặc kho lưu trữ công khai.
/v1/ws/ticket với X-API-Key header, sau đó kết nối bằng vé nhận được. Xem Xác thực WebSocket (vé).Đăng nhập bằng Google (Firebase Auth)
Người dùng có thể xác thực bằng tài khoản Google qua Firebase Authentication. Sau khi đăng nhập Google thành công trên client, đổi token ID Firebase để lấy phiên API liên kết. Hệ thống tự động đồng bộ danh tính Google với hệ thống API key.
Request Body
| Trường | Kiểu | Mô tả |
|---|---|---|
| id_tokenbắt buộc | string | Token ID Firebase nhận được sau khi đăng nhập Google trên client |
Ví dụ phản hồi
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}
Giới hạn tốc độ
| Gói | Lượt gọi/Ngày | Giới hạn bùng nổ | Độ trễ dữ liệu |
|---|---|---|---|
| Miễn phí | 50 | 2/phút | 60 giây |
| Trader | 1,000 | 20/phút | Thời gian thực |
| Pro | 5,000 | 60/phút | Thời gian thực |
| Doanh nghiệp | 100,000 | 400/phút | Thời gian thực |
Tiêu đề giới hạn tốc độ được bao gồm trong mọi phản hồi: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
URL cơ sở
Tất cả các điểm cuối bên dưới đều liên quan đến URL cơ sở này. Tất cả phản hồi đều là JSON với Content-Type: application/json.
Lỗi
Lỗi sử dụng mã trạng thái HTTP tiêu chuẩn và một nội dung JSON nhất quán. Luôn phân nhánh dựa trên mã trạng thái, không phải trên văn bản phản hồi. Ba lỗi bạn sẽ gặp thường xuyên nhất:
| Trạng thái | Mã | Ý nghĩa & hành động cần thực hiện |
|---|---|---|
| 401 | unauthorized | Thiếu hoặc khóa API không hợp lệ. Kiểm tra X-API-Key tiêu đề có hiện diện và chính xác. |
| 402 | payment_required | Điểm cuối hoặc biểu tượng yêu cầu gói cao hơn so với khóa của bạn (ví dụ: khóa miễn phí gọi WebSocket firehose). Nâng cấp hoặc quay lại sử dụng điểm cuối công khai. |
| 429 | rate_limit_exceeded | Đạt đến giới hạn hàng ngày hoặc giới hạn bùng nổ. Tạm dừng và thử lại sau X-RateLimit-Reset; không gửi liên tục. |
Mọi lỗi đều trả về cùng một định dạng:
"error": "rate_limit_exceeded",
"message": "Đạt đến giới hạn 100 cuộc gọi hàng ngày. Đặt lại lúc 00:00 UTC.",
"status": 429
}
Để xem danh sách đầy đủ các mã trạng thái (400 / 403 / 500 / 503 và nhiều hơn nữa), hãy xem Mã lỗi. Một tích hợp mạnh mẽ xử lý 5xx và 429 là tạm thời (thử lại với backoff) và 401/402/403 là cuối cùng (sửa khóa hoặc gói).
Các phương pháp bảo mật tốt nhất
Gửi khóa trong tiêu đề, không bao giờ trong URL. Luôn truyền X-API-Key như một tiêu đề HTTP. Khóa trong chuỗi truy vấn (?key=) được ghi lại bởi proxy, cân bằng tải và lịch sử trình duyệt — tính năng ?key= auth không còn được chấp nhận trên các điểm cuối WebSocket vì lý do này.
Giữ khóa ở phía máy chủ. Không bao giờ nhúng khóa API vào JavaScript phía máy khách, gói ứng dụng di động hoặc kho lưu trữ công khai. Tải nó từ biến môi trường hoặc trình quản lý bí mật. Nếu khóa bị rò rỉ, hãy xoay nó.
Xoay khóa định kỳ. Tạo lại khóa của bạn từ bảng điều khiển theo lịch trình và ngay lập tức nếu bạn nghi ngờ bị lộ. Khóa cũ ngừng hoạt động ngay khi khóa mới được phát hành.
Sử dụng vé cho ổ cắm trình duyệt. Đối với luồng thời gian thực từ trình duyệt, hãy đổi khóa của bạn lấy vé dùng một lần thay vì kết nối bằng khóa thô — xem Xác thực WebSocket (vé).
Sử dụng với các tác nhân mã hóa / LLM
Đang xây dựng với Claude Code, Codex, Cursor hoặc bất kỳ tác nhân mã hóa LLM nào? Bạn có thể cung cấp cho tác nhân mọi thứ cần thiết để kết nối API này một cách chính xác trong một lần. Hai tài liệu tham khảo có thể đọc được bằng máy được xuất bản:
| Tài nguyên | URL |
|---|---|
| Tóm tắt LLM | https://smartmoneyapi.com/llms.txt |
| Thông số kỹ thuật OpenAPI | github.com/tashiardit/smartmoneyapi-docs |
Chỉ tác nhân của bạn vào /llms.txt tệp (theo quy ước llms.txt) để có cái nhìn tổng quan ngắn gọn, sau đó là thông số kỹ thuật OpenAPI cho các hình dạng yêu cầu/phản hồi chính xác. Một dòng nhắc hoạt động tốt:
Đọc https://smartmoneyapi.com/llms.txt và thông số kỹ thuật OpenAPI tại
github.com/tashiardit/smartmoneyapi-docs, sau đó thêm kiểm tra trước giao dịch
vào bot của tôi gọi GET /v1/confirm và bỏ qua các mục nhập
trừ khi hành động là CONFIRM.
Xem Sách công thức để biết công thức làm việc với tác nhân mã hóa.
Điểm cuối
GET /confirm
Điểm cuối cốt lõi. Trả về điểm tin cậy tổng hợp và khuyến nghị hành động cho một hướng giao dịch nhất định. Gọi điểm cuối này trước khi vào bất kỳ vị thế nào.
Phạm vi bao phủ, nói một cách đơn giản. /confirm hiện đang chấm điểm BTC, ETH và SOL — các biểu tượng có đủ lịch sử giải quyết để xác nhận trung thực. Trình kiểm tra phái sinh riêng biệt giám sát ~519 thị trường phái sinh cho dữ liệu tài trợ, OI và thanh lý, và theo dõi cá voi bao gồm hơn 600 ví. Pro mở khóa trình kiểm tra đầy đủ, xuất và phạm vi thị trường rộng hơn; /confirm hỗ trợ biểu tượng được mở rộng khi mỗi thị trường tích lũy một hồ sơ theo dõi đáng tin cậy.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symbolbắt buộc | chuỗi | Biểu tượng tài sản. Một trong: BTC, ETH, SOL (Trader+) |
| directionbắt buộc | chuỗi | Hướng giao dịch: long hoặc short |
| sourcetùy chọn | chuỗi | Nhãn cho nguồn tín hiệu của bạn (được ghi lại để phân tích). Tối đa 32 ký tự. |
Ví dụ yêu cầu
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
Ví dụ phản hồi
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "CAO",
"action": "CONFIRM_FULL",
"size_mult": 1.5,
deriv_score: 0.81,
onchain_score: 0.68,
whale_score: 0.73,
x_score: 0.0,
yếu tố: {
phái sinh: { điểm số: 0.81, trọng số: 0.40, có trọng số: 0.324 },
onchain: { điểm số: 0.68, trọng số: 0.35, có trọng số: 0.238, nguồn: coinmetrics, khả dụng: True },
cá voi: { điểm số: 0.73, trọng số: 0.25, hệ số lỗi thời: 1.0, có trọng số: 0.183 }
},
điều chỉnh: { sự đồng thuận: 0.0, xu hướng: 0.0, tin tức vĩ mô: 0.0 },
trọng số: { phái sinh: 0.40, onchain: 0.35, thông tin cá voi: 0.25 },
phạm vi: { phái sinh: True, cá voi: True, onchain: True },
lý do: [
Tỷ lệ tài trợ dương trên tất cả sàn,
LSR nghiêng về long: 1.42,
Cá voi: 67% đồng thuận long,
MVRV trên 1.0 — tín hiệu tăng on-chain
]
}
Minh bạch theo thiết kế. Mỗi phản hồi bao gồm một factors đối tượng hiển thị điểm số × trọng số = giá trị có trọng số đóng góp, một adjustments đối tượng để tinh chỉnh sau lọc, các weights được sử dụng, và một coverage bản đồ. Phần on-chain sử dụng dữ liệu miễn phí thực tế từ Coin Metrics (MVRV / dòng tiền sàn / địa chỉ hoạt động) khi không có key Glassnode. Đây là hệ thống đa yếu tố hội tụ điểm số — hỗ trợ quyết định, không đảm bảo tỷ lệ thắng.
Các mã không theo dõi được đánh giá trung thực. Mã ngoài phạm vi phái sinh/cá voi sẽ trả về "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" rõ ràng với "unsupported":true — không bao giờ bịa đặt LOW.
Các Trường Phản Hồi
| Trường | Loại | Mô tả |
|---|---|---|
| ts | số nguyên | Mốc thời gian Unix của phép tính |
| symbol | chuỗi | Mã tài sản (BTC/ETH/SOL) |
| direction | chuỗi | Hướng yêu cầu (long/short) |
| composite | số thực | Điểm hội tụ tổng hợp từ -1.0 (cực kỳ ngược) đến +1.0 (xác nhận mạnh). Không phải tỷ lệ thắng. |
| base_composite | số thực | Tổng hợp trước khi áp dụng điều chỉnh sau lọc |
| confidence | chuỗi | HIGH / MEDIUM / LOW / VETO / NO_DATA |
| hành động | chuỗi | CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP |
| size_mult | số thực | Hệ số nhân kích thước vị thế đề xuất (vd: 0.0 – 1.5) |
| unsupported | boolean | true khi mã nằm ngoài phạm vi (kèm NO_DATA) |
| deriv_score | số thực | Điểm phái sinh (-1 đến 1) |
| onchain_score | số thực | Điểm on-chain (-1 đến 1) |
| whale_score | số thực | Điểm đồng thuận cá voi (-1 đến 1) |
| x_score | số thực | Điểm X/sentiment mạng xã hội (-1 đến 1); 0 khi không dùng |
| factors | đối tượng | Chi tiết từng thành phần: score × weight = weighted cho phái sinh / onchain / cá voi / x_sentiment (onchain bao gồm source) |
| adjustments | đối tượng | Điều chỉnh sau lọc (đồng thuận, xu hướng, rsi_1h, tin vĩ mô, đà, thời điểm, suy giảm chuỗi) |
| weights | đối tượng | Bộ trọng số thực tế được sử dụng |
| coverage | đối tượng | {derivatives, whale, onchain} — các thành phần có dữ liệu thực |
| reasons | mảng | Giải thích bằng ngôn ngữ tự nhiên cho điểm số |
GET /snapshot
Trả về ảnh chụp toàn thị trường bao gồm tất cả điểm thành phần, số liệu thô và giá trị chỉ báo cho một mã. Hữu ích cho dashboard và ghi nhật ký.
GET /onchain
Trả về các chỉ số on-chain thô: MVRV, SOPR, dòng chảy ròng trên sàn, tỷ lệ vốn hóa thực tế và phân loại vị thế chu kỳ.
GET /v1/derivatives/*
Màn hình phái sinh đa sàn với 500+ cặp: bản đồ nhiệt funding-rate, xếp hạng open-interest và phát hiện tín hiệu tỷ lệ long/short. 10 hàng đầu công khai; toàn bộ màn hình yêu cầu Trader hoặc Pro. Các endpoint: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.
GET /v1/options/*
Phân tích quyền chọn BTC & ETH từ Deribit (công khai, không cần xác thực): tỷ lệ put/call, max pain và open interest theo strike. Các endpoint: /v1/options/summary, /v1/options/pcr, /v1/options/oi.
GET /v1/etf/*
Dòng chảy ròng hàng ngày và chi tiết từng quỹ ETF BTC & ETH spot (công khai). Các endpoint: /v1/etf/flows, /v1/etf/funds.
GET /v1/historical/*
Dữ liệu lịch sử funding, open interest, tỷ lệ long/short (Binance) và OHLCV (CoinGecko) cho backtesting. Các endpoint: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.
GET /v1/dex/*
Các cặp giao dịch trending, tìm kiếm token và chi tiết cặp từ DexScreener (công khai, không cần xác thực). Các endpoint: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.
GET /v1/news/*
Tin tức thông minh: tin chính sách/địa chính trị/crypto phân loại theo mức độ ảnh hưởng, kèm chỉ số Fear & Greed (công khai). Các endpoint: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.
GET /whales
Trả về dữ liệu đồng thuận ví cá voi: phân chia long/short, tổng exposure danh nghĩa, top 10 vị thế (chỉ Pro) và số lượng ví.
GET /signals
Trả về luồng tín hiệu HIGH/MEDIUM gần nhất trên tất cả tài sản được giám sát. Hữu ích để quét cơ hội.
GET /v1/strategies/*
Lịch sử minh bạch, chỉ đọc cho các chiến lược giao dịch tự động thực thi dựa trên tín hiệu Smart Money — bao gồm deriv40 Chiến lược Copytrade SmartMoney (account=9). Tất cả endpoint nhận ?account=<id> query parameter và trả về JSON. Không cần xác thực (lịch sử công khai).
Các endpoint
GET /v1/strategies/stats?account=9— chỉ số chính:total_trades,win_rate,profit_factor,total_pnl_usdt,account_growth_percent,initial_equity,current_equity,max_drawdown_portfolio,max_drawdown_trade.GET /v1/strategies/equity?account=9— đường cong vốn để vẽ biểu đồ:{ initial_equity, curve: [{ time, equity }] }.GET /v1/strategies/trades?account=9&limit=500— sổ lệnh đã đóng: mảng (hoặc{trades:[…]}) củasymbol,direction,entry_price,exit_price,pnl_usdt,pnl_percent,pnl_percent_net.GET /v1/strategies/active?account=9— vị thế đang mở: mảng (hoặc{positions:[…]}) củasymbol,side/direction,entry_price,unrealized_pnl.GET /v1/strategies/signals— phân loại theo loại tín hiệu cung cấp cho chiến lược (số lượng / thắng / tỷ lệ thắng / lợi nhuận trung bình theo loại tín hiệu).
Hiệu suất trong quá khứ không đảm bảo kết quả tương lai. Dữ liệu được backfill trong ~3 tháng gần nhất cùng giao dịch live và hiển thị trước phí (nếu có ghi chú).
GET /export
Tải dữ liệu tín hiệu lịch sử dạng CSV để backtesting. Tham số: symbol, from (unix ts), to (unix ts).
GET /health
Kiểm tra tình trạng hệ thống. Trả về độ mới dữ liệu từng nguồn và trạng thái tổng thể API. Không cần xác thực.
"status": "ok",
"uptime_s": 1209600,
"sources": {
"bybit": { "lag_s": 42, "ok": true },
"binance": { "lag_s": 38, "ok": true },
"hyperliquid": { "lag_s": 61, "ok": true },
"onchain": { "lag_s": 290, "ok": true }
}
}
GET /usage
Trả về thống kê sử dụng API hiện tại: số lần gọi hôm nay, tổng tháng, giới hạn hạn ngạch và thời gian reset.
POST /webhooks
Đăng ký URL HTTPS để nhận sự kiện đẩy thời gian thực có chữ ký khi tín hiệu kích hoạt trên tài sản giám sát. Giao hàng có X-SmartMoney-Event header và chữ ký HMAC-SHA256 trong X-SmartMoney-Signature, và thử lại tối đa 3 lần với backoff.
Request Body
| Trường | Loại | Mô tả |
|---|---|---|
| urlbắt buộc | chuỗi | Endpoint HTTPS để POST sự kiện (phải bắt đầu bằng https://) |
| eventsbắt buộc | mảng | Tên sự kiện, ví dụ ["HIGH","MEDIUM","VETO"] hoặc ["*"] |
| symbolsbắt buộc | mảng | Các ký hiệu lọc, ví dụ ["BTC","ETH"] hoặc ["*"] |
| secretbắt buộc | chuỗi | Chuỗi bí mật ký của bạn, ≥ 16 ký tự (được lưu dạng hash) |
Xác minh chữ ký
Khóa HMAC là mã hex SHA-256 của chuỗi bí mật đã đăng ký. Tính HMAC-SHA256 của request body thô với khóa đó và so sánh (constant-time) với X-SmartMoney-Signature. Xem Hướng dẫn triển khai Webhook.
Thông tin thị trường
GET /analysis
Trả về phân loại chế độ thị trường bằng AI với khả năng phát hiện xung đột tín hiệu. Phân tích sự đồng thuận giữa các tín hiệu, xác định sự phân kỳ giữa dữ liệu phái sinh, on-chain và dữ liệu cá voi, đồng thời tạo ra bản tóm tắt bằng ngôn ngữ tự nhiên với các yếu tố rủi ro hướng tới tương lai và khuyến nghị theo khung thời gian.
Tham số
| Tham số | Kiểu | Mô tả |
|---|---|---|
| symbolbắt buộc | string | Ký hiệu tài sản: BTC, ETH, hoặc SOL |
Ví dụ phản hồi
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "Giai đoạn cuối chu kỳ — Phân kỳ tín hiệu",
"summary": "BTC đang trong giai đoạn cuối chu kỳ tăng giá với sức mạnh on-chain mâu thuẫn với sự mở rộng quá mức của phái sinh. Cá voi đang giảm tiếp xúc trong khi LSR bán lẻ tăng.",
"signal_conflicts": [
"Điểm cá voi giảm trong khi điểm on-chain tăng",
"Tỷ lệ funding ở mức cao nhất 3 tháng — rủi ro squeeze tiềm ẩn"
],
"risk_factors": ["Funding cao", "Phân kỳ OI", "Giảm tiếp xúc cá voi"],
"recommendation": "Giảm tiếp xúc long, thắt chặt stop. Tránh mở long mới trên giá hiện tại.",
"time_horizon": "4h–12h"
}
GET /liquidations
Trả về hai góc nhìn bổ sung: (1) dự đoán đòn bẩy levels — ước tính nơi các cụm thanh lý nằm; và (2) một realized_heatmap — THỰC TẾ đã thực hiện cường độ thanh lý cưỡng bức (giá × thời gian), tổng hợp trực tiếp từ các feed WebSocket của sàn giao dịch công khai: Binance, OKX, Bybit, Bitget, BitMEX. Heatmap hiển thị khi stream có dữ liệu cho ký hiệu (không có trong thị trường cực kỳ yên lặng hoặc ngay sau khi khởi động).
Tham số
| Tham số | Kiểu | Mô tả |
|---|---|---|
| symboltùy chọn | string | Ký hiệu tài sản (mặc định BTC). Heatmap thực tế bao gồm các ký hiệu perp được giao dịch tích cực. |
Ví dụ phản hồi
"symbol": "BTC",
"cascade_risk": "CAO",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// THỰC TẾ đã thanh lý — trực tiếp từ 5 sàn giao dịch
"realized_heatmap": {
"window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
"clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
}
}
cascade_risk, khoảng cách gần nhất và tổng/theo bên đã thực hiện. Gói Pro: dự đoán đầy đủ levels cộng với realized_heatmap đầy đủ (ma trận, cụm theo giá, số lượng theo sàn). Ước tính dự đoán trả lời "các stop nằm ở đâu"; heatmap thực tế cho thấy "những gì thực sự đã bị thanh lý."GET /liquidations/heatmap
Công khai heatmap thanh lý theo mức giá. Trả về ma trận giá × thời gian kiểu Coinglass của THỰC TẾ đã thực hiện các lệnh thanh lý cưỡng bức, được nhóm theo giá tại đó mỗi lệnh thanh lý được thực hiện — tổng hợp trực tiếp từ các feed WebSocket của sàn giao dịch công khai: Binance, OKX, Bybit, Bitget, BitMEX. Mảng clusters là đầu ra thực tế: các nhóm giá được xếp hạng theo notional đã thanh lý, mỗi nhóm được gắn nhãn theo bên chiếm ưu thế. Dữ liệu phụ thuộc vào live stream — một ký hiệu cực kỳ yên lặng hoặc gateway vừa khởi động lại sẽ trả về cấu trúc trống được định dạng tốt cùng với một note. Các mức hiển thị chỉ là thanh lý thực tế, không bao giờ là ước tính.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboltùy chọn | chuỗi | Ký hiệu tài sản (mặc định BTC). |
| window_minutestùy chọn | int | Cửa sổ thời gian nhìn lại tính bằng phút (mặc định 240, giới hạn từ 5–1440). |
| price_bucketstùy chọn | int | Số lượng nhóm giá (mặc định 50, giới hạn từ 5–100). |
Ví dụ phản hồi
"symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
"price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
"price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
"matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
"clusters": [
{ "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
"short_notional": 720000.0, "count": 37, "dominant_side": "long" }
],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
"generated_at": 1710940200, "public": true
}
totals.count là 0, clusters trống, và một note trường giải thích lý do. Đây là bản ghi các lệnh thanh lý đã thực thi — không phải dự đoán. Để ước tính dự kiến "các lệnh dừng lỗ nằm ở đâu", hãy sử dụng điểm cuối xác thực /liquidations điểm cuối.GET /liquidations/onchain
Đã thực thi các lệnh thanh lý cho vay DeFi trên chuỗi được ghi nhận trực tiếp từ hệ thống cục bộ của chúng tôi BSC + Avalanche full nodes — độc lập với bất kỳ bot giao dịch nào. Bao gồm Venus/Cream và Moolah trên BSC, và AAVE V3/V2, Benqi, BankerJoe, Granary và Vinium trên Avalanche. Gói Pro bổ sung trả về at_risk vị thế (phụ thuộc vào bot, có thể không có).
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| chaintùy chọn | string | bsc hoặc avax. Bỏ qua cho tất cả các chain. |
| limittùy chọn | integer | Số dòng tối đa (mặc định 100, tối đa 500). Mới nhất trước. |
Ví dụ phản hồi
"chain": "bsc", "count": 2,
"liquidations": [
{ "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
"debt_symbol": "DAI", "repay_usd": 426.15,
"collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
],
"summary": {
"window_hours": 24, "enabled": true,
"by_protocol": { "bsc:Venus": { "count": 61, repay_usd_known: 148230.55 } },
nodes: { bsc: { reachable: true, head_block: 89173010, events_total: 61 } }
}
}
GET /smart-stop
Tính toán các mức cắt lỗ thông minh dựa trên bản đồ nhiệt thanh lý hiện tại, dải biến động và cấu trúc thị trường. Trả về các đề xuất cắt lỗ phân cấp và gợi ý chốt lời được điều chỉnh theo giá vào lệnh và mức chịu rủi ro của bạn.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symbolbắt buộc | string | Ký hiệu tài sản: BTC, ETH, hoặc SOL |
| directionbắt buộc | string | Hướng vị thế: long hoặc short |
| entry_pricetùy chọn | float | Giá vào lệnh của bạn. Mặc định là giá thị trường hiện tại nếu bỏ qua. |
| risk_pcttùy chọn | float | Rủi ro tối đa chấp nhận được tính theo % tài khoản. Mặc định: 2.0 |
Ví dụ phản hồi
symbol: BTC,
direction: long,
entry_price: 96420,
stops: {
tight: { price: 95100, note: Dưới cấu trúc 1h. Tốt nhất cho giao dịch lướt sóng. },
recommended: { price: 93800, note: Dưới cụm thanh lý chính ở mức $94K. Mức cắt lỗ tiêu chuẩn cho giao dịch swing. },
wide: { price: 91200, note: Dưới vùng cầu 4h. Mức cắt lỗ cho giao dịch vị thế. }
},
avoid_zones: [
{ low: 94200, high: 94800, reason: Cụm thanh lý dày đặc — rủi ro trượt giá cao }
],
take_profit_suggestions: [
{ tp1: 98500, tp2: 101000, tp3: 104200 }
]
}
recommended chỉ mức cắt lỗ. Gói Pro: Cả ba mức cắt lỗ, avoid_zones, và đầy đủ gợi ý chốt lời.GET /funding-arb
Xác định cơ hội arbitrage tỷ lệ funding chéo sàn trong thời gian thực. Trả về các cơ hội được xếp hạng với lợi suất hàng năm ước tính, cặp sàn tối ưu và hành động phòng ngừa cần thiết để nắm bắt chênh lệch.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| min_spreadtùy chọn | float | Chênh lệch tỷ lệ funding tối thiểu để bao gồm (dưới dạng thập phân). Mặc định: 0.01 |
| symboltùy chọn | string | Lọc theo một tài sản cụ thể. Bỏ qua để quét tất cả các tài sản được hỗ trợ. |
Ví dụ phản hồi
ts: 1710940821,
opportunities: [
{
symbol: BTC,
spread: 0.032,
apr: 84.2,
long_exchange: hyperliquid,
short_exchange: bybit,
action: Long HYPE / Short BYBIT,
estimated_profit_8h_usd: 26.4
}
]
}
Phiên bản công khai miễn phí Không cần xác thực
Một endpoint công khai không cần khóa trả về 10 cơ hội hàng đầu với bộ lọc chéo sàn trực tiếp, lý tưởng để nhúng hoặc kiểm tra nhanh. Nó bỏ qua lịch sử chênh lệch theo từng ký hiệu và các trường nặng, được phục vụ từ bộ nhớ cache 120 giây. Khi không có chênh lệch funding chéo sàn trong cửa sổ thời gian mới nhất, nó trả về một opportunities mảng trống với một note — không bao giờ bịa đặt dữ liệu.
opportunities: [
{
ký hiệu: OGN,
chênh lệch phần trăm: 0.297667,
lãi suất hàng năm: 325.95,
sàn giao dịch dài hạn: bybit,
sàn giao dịch ngắn hạn: hyperliquid,
lợi nhuận ước tính trên 10k: 29.77,
ghi chú rủi ro: Chênh lệch thấp — đảm bảo phí không làm giảm biên độ chênh lệch.
}
],
các ký hiệu được quét: 222,
ts: 1783268753,
công khai: true,
giới hạn: true
}
GET /smart-money/flow
Một chỉ số định hướng cá voi có trọng số chất lượng chỉ số định hướng cá voi theo từng ký hiệu, được chấm điểm -100 (tiền cá voi nghiêng về bán) đến +100 (nghiêng về mua). Được xây dựng từ hàng nghìn ví cá voi Hyperliquid được theo dõi — mỗi ví được đánh giá dựa trên tỷ lệ thắng và PnL lịch sử của nó và giảm dần theo thời gian. Đây là chỉ số định vị, không phải tín hiệu mua/bán hoặc dự đoán giá. Các ký hiệu có ít ví đóng góp được đánh dấu thin và được chấm điểm một cách trung thực. Trang trực tiếp: smart-money-flow.html.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| ký hiệutùy chọn | chuỗi | Một ký hiệu duy nhất (ví dụ: BTC). Bỏ qua để nhận tất cả các ký hiệu được theo dõi xếp hạng theo |điểm|. |
| window_hourstùy chọn | int | Cửa sổ chấm điểm, được giới hạn đến 1..168. Mặc định 24. |
Ví dụ phản hồi
các ký hiệu: [
{
ký hiệu: SPX,
điểm: -90.93,
hướng: mạnh bán,
n_wallets: 26,
mua_usd: 184200.0, bán_usd: 2410000.0,
có trọng số chất lượng: true,
mẫu chất lượng: phong phú,
những người đóng góp hàng đầu: [ { ví: 0x31ca…974b, hướng: bán, giá trị_usd: 5338.25, trọng số: 0.4948 } ]
}
],
window_hours: 24,
có trọng số chất lượng: true,
ts: 1783270000,
ghi chú: Chỉ số định vị định hướng cá voi có trọng số chất lượng (-100..+100). Không phải là dự đoán giá hoặc tín hiệu mua/bán.
}
top_contributors. Trọng số ví được giới hạn đến [0.25,1.0]; PnL là một proxy chưa thực hiện từ các bản chụp vị trí mới nhất.GET /v1/whales/crowding
Kết hợp bối cảnh định vị và đông đúc cá voi theo từng ký hiệu, hợp nhất qua Hyperliquid + GMX v2 + Jupiter Perps. Trả về tổng/ròng danh nghĩa, độ lệch hướng, số lượng ví và địa điểm, tập trung vị trí (chia sẻ top-3 + HHI), đòn bẩy trung bình có trọng số, và các nhóm gần thanh lý (danh nghĩa nằm trong khoảng 5% và 10% của giá thanh lý ước tính, chia thành mua/bán). Đây là bối cảnh, không phải tín hiệu định hướng. Các trường không thể suy ra được null và hiển thị là — — ví dụ lev_wavg/crowding_index khi không có vị trí nào mang đòn bẩy. Khoảng cách thanh lý là ước tính ký quỹ riêng biệt (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), không phải giá thanh lý được báo cáo bởi sàn giao dịch.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| min_notionaltùy chọn | float | Tổng danh nghĩa tối thiểu (USD) để một ký hiệu được bao gồm. Mặc định: 1000000. |
Ví dụ yêu cầu
Ví dụ phản hồi
"ok": true, "ts": 1783423500, min_notional: 1000000, n_symbols: 92,
symbols: [
{
symbol: BTC,
gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
n_whales: 414, n_venues: 3,
venues: {
hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
},
conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
crowding_index: 0.003
}
],
caveats: [ Khoảng cách thanh lý là ước tính margin biệt lập, không phải do sàn báo cáo. ]
}
skew là net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). Chỉ các sàn thực sự hiện diện mới xuất hiện trong venues. Các vị thế không sử dụng đòn bẩy được loại khỏi nhóm thanh lý thay vì giả định. Người gọi ẩn danh nhận được top 10 symbol theo gross (với gated: true); Trader+ nhận danh sách đầy đủ.GET /v1/options/gex
Dealer gamma exposure (GEX) phân tích cho BTC & ETH, tính toán trực tiếp từ chuỗi option công khai Deribit (không cần xác thực). Trả về GEX ròng của dealer theo strike (quy ước dealer-short SpotGamma), mức gamma-flip (strike nơi GEX ròng tích lũy vượt zero), cấu trúc kỳ hạn IV (ATM implied vol theo ngày đến hạn), và skew IV kỳ hạn đầu IV skew (25Δ-proxy risk reversal). Chế độ GEX là positive (dealer dài gamma → áp chế biến động) hoặc negative (khuếch đại biến động). Hoàn toàn độc lập — tính lại mỗi lần gọi, không phụ thuộc CSDL lưu trữ.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboltùy chọn | string | BTC hoặc ETH chỉ. Mặc định: BTC. |
Ví dụ yêu cầu
Ví dụ phản hồi
"symbol": "BTC", "available": true, "spot": 63203.0,
"net_gex": 18240000.0, "regime": "positive",
"gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
"call_gex": 31200000.0, "put_gex": -12960000.0,
"by_strike": [
{ "strike": 60000, "net_gex": -2100000.0 },
{ "strike": 65000, "net_gex": 4800000.0 }
],
"term_structure": [
{ "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
{ "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
],
"skew": {
"expiry": "8JUL26", "dte": 0.76,
"put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
"risk_reversal": 14.35, "bias": "downside_fear"
}
}
available: false với panel trống — không bao giờ tạo GEX giả. IV skew sử dụng proxy strike cố định ±10% cho 25Δ (25-delta thực yêu cầu giải delta mỗi strike); đủ hiển thị, được ghi chú là xấp xỉ.GET /v1/liquidations/simulate
Interactive kiểm tra áp lực chuỗi thanh lýVới một biến động giá giả định, trả về ước tính các vị thế đòn bẩy sẽ bị thanh lý, khối lượng ép buộc theo mức giá / hướng / sàn giao dịch và báo cáo độ sâu chuỗi. Một biến động giảm sẽ thanh lý vị thế mua có giá thanh lý nằm ở/trên mục tiêu; một biến động tăng sẽ thanh lý vị thế bán có giá thanh lý nằm ở/dưới mục tiêu. Hai phương pháp độc lập được kết hợp: giá thanh lý chính xác từ các 'cá voi' Hyperliquid được theo dõi thực tế đòn bẩy/điểm vào, cộng với các cụm dải OI thống kê theo sàn (đòn bẩy đám đông suy ra từ funding). Mọi thứ được ghi rõ ràng estimated: true — không thể biết margin từng tài khoản, cross vs isolated, margin bổ sung, hoặc ADL.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboltùy chọn | string | Ký hiệu tài sản. Mặc định: BTC. |
| move_pcttùy chọn | float | Biến động giá giả định theo phần trăm (âm = giảm, dương = tăng). Mặc định: -5. |
Yêu cầu mẫu
Phản hồi mẫu
"ok": true, "estimated": true, "symbol": "BTC",
"ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
"triggered_notional_usd": 380000000.0,
"cascade_depth": 0.029, "cascade_bucket": "low",
"by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
"by_side": { "long": 380000000.0, "short": 0.0 },
"clusters": [
{ "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
],
"whale_positions_used": 272, "exchanges": 3,
"realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
"methodology": { "disclaimer": "Ước tính — không thể biết margin từng tài khoản, cross vs isolated, margin bổ sung, hoặc ADL." }
}
ok: true, empty: true với thông báo bằng tiếng Anh đơn giản, không phải dữ liệu giả. realized_context là một mẫu nhỏ, đang phát triển từ luồng thanh lý ép buộc trực tiếp, chỉ hiển thị như ngữ cảnh — nó không bao giờ làm cho dự đoán trở thành 'hiện thực'.GET /v1/wallet/{addr}/profile
Một hồ sơ ví đa sàn được xây dựng hoàn toàn từ ảnh chụp vị thế cá voi được theo dõi trực tiếp. Đối với một cá voi Hyperliquid được theo dõi, trả về các vị thế mở hiện tại, chuỗi thời gian PnL chưa thực hiện / mức phơi nhiễm / số lượng vị thế chuỗi thời gian, một dòng thời gian hoạt động OPEN/CLOSE/FLIP (được tái tạo bằng cách so sánh các ảnh chụp liên tiếp), nhãn bảng xếp hạng HL được giải mã và bản tóm tắt sổ lệnh mở. Trang trực tiếp: wallet-profiler.html.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| addrbắt buộc | string | Địa chỉ ví (phần đường dẫn), ví dụ /v1/wallet/0x3bcae23e…/profile. |
| daystùy chọn | integer | Cửa sổ quay lại cho chuỗi & dòng thời gian. Mặc định: 30. |
Yêu cầu mẫu
Phản hồi mẫu
"ok": true, "wallet": "0x3bcae23e…", "tracked": true,
"first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
"hyperliquid": {
"label": { "name": "Andre is back", "score": 74,
"window_pnl_usd": 1307000, tỷ_lệ_thắng_%: 71, giao_dịch: 42 },
vị_thế: [
{ sàn_giao_dịch: hyperliquid, mã: ETH, hướng: bán_khống,
quy_mô: 1200.0, giá_vào_lệnh: 1800.0, lãi/lỗ_hiện_tại: 34800.0,
đòn_bẩy: 20.0, giá_trị_USD: 2160000.0 }
],
chuỗi: [ { thời_gian: 1783330000, lãi/lỗ_hiện_tại: 42000.0, rủi_ro_USD: 18400000.0, vị_thế: 5 } ],
dòng_thời_gian: [ { thời_gian: 1783400000, sự_kiện: đảo_chiều, mã: ETH,
hướng: bán_khống, từ_hướng: mua, giá_trị_USD: 2160000.0 } ],
tổng_quan: {
vị_thế_mở: 5, có_lãi: 3, bị_lỗ: 2, mua: 0, bán_khống: 5,
tổng_lãi/lỗ_hiện_tại: -12000.0, tổng_rủi_ro_USD: 21000000.0, đòn_bẩy_trung_bình: 19.9,
số_ngày_cửa_sổ: 30, ảnh_chụp_trong_cửa_sổ: 474,
lãi/lỗ_thực_tế: None, ghi_chú_lãi/lỗ_thực_tế: Không thể suy ra — chỉ thấy ảnh chụp mở, không thấy lệnh đóng.
}
}
}
pnl là giá trị đánh dấu thị trường chưa thực hiện của HL, value_usd là mệnh giá mở. Lãi/lỗ thực hiện theo giao dịch trọn vòng không khả dụng (chúng tôi chỉ thấy ảnh chụp mở, không thấy lệnh đóng) và được hiển thị là null / —; sự kiện ĐÓNG trong dòng thời gian không mang thông tin Lãi/lỗ. Một địa chỉ hợp lệ nhưng không theo dõi trả về tracked: false với ghi chú; một địa chỉ không hợp lệ trả về ok: false, error: "invalid_address" (HTTP 400). Nhãn bảng xếp hạng HL là thứ hạng cửa sổ của HL khi phát hiện, không phải do chúng tôi tính toán.GET /flows
Trả về dữ liệu dòng vốn đa tài sản thể hiện mô hình luân chuyển giữa BTC, ETH và SOL trên nhiều khung thời gian. Hữu ích để xác định tài sản nào đang tích lũy vốn và tài sản nào đang bị phân phối tại bất kỳ thời điểm nào.
Ví dụ phản hồi
"ts": 1710940821,
"flows": {
"BTC": { "1h": 142000000, "4h": 380000000, "12h": -90000000, "24h": 220000000 },
"ETH": { "1h": -38000000, "4h": -110000000, "12h": 55000000, "24h": -80000000 },
"SOL": { "1h": 12000000, "4h": 29000000, "12h": 18000000, "24h": 44000000 }
},
"rotations_detected": [
"Vốn luân chuyển từ ETH sang BTC trong khung 4h",
"SOL tích lũy ổn định trên mọi khung thời gian"
]
}
GET /whale-events
Trả về các thay đổi vị thế cá voi quan trọng — mở, đóng và đảo chiều — được phát hiện trên các ví và địa chỉ on-chain được theo dõi trong khung thời gian tra cứu.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboltùy chọn | chuỗi | Lọc theo tài sản. Bỏ trống để áp dụng cho tất cả tài sản được giám sát. |
| significancetùy chọn | chuỗi | Lọc theo mức độ quan trọng sự kiện: high, medium, hoặc all. Mặc định: all |
| hourstùy chọn | số nguyên | Khung thời gian tra cứu (giờ). Mặc định: 24 |
Ví dụ phản hồi
"symbol": "BTC",
"summary": {
"flips_to_long": 3,
"flips_to_short": 1,
"new_opens": 7,
"closes": 2
},
"events": [
{
"type": "flip_long",
"wallet": "0xWhale...a4f2",
"direction": "long",
"size_usd": 4200000,
"ts": 1710938400
}
]
}
summary đối tượng duy nhất. Kế hoạch Pro: Đầy đủ events luồng dữ liệu với định danh ví, kích thước và dấu thời gian.GET /regimes/history
Trả về dữ liệu phân loại chế độ lịch sử cho một tài sản cụ thể. Sử dụng để kiểm tra ngược hiệu suất của các loại chế độ cụ thể trong lịch sử, thời gian kéo dài trung bình của mỗi chế độ và cách các chuyển đổi chế độ diễn ra theo thời gian.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboloptional | string | Ký hiệu tài sản. Mặc định: BTC |
| regimeoptional | string | Lọc theo loại chế độ cụ thể, ví dụ late_cycle_divergence. Bỏ qua để lấy tất cả chế độ. |
| daysoptional | integer | Cửa sổ nhìn lại theo ngày. Mặc định: 30. Tối đa: 365 |
Ví dụ phản hồi
"symbol": "BTC",
"current_regime": "late_cycle_divergence",
"regime_summary": {
"late_cycle_divergence": { "occurrences": 4, "avg_duration_h": 38, "avg_return_pct": -2.1 },
"accumulation": { "occurrences": 6, "avg_duration_h": 72, "avg_return_pct": 5.4 },
"breakout": { "occurrences": 3, "avg_duration_h": 18, "avg_return_pct": 9.2 }
},
"transitions": [
{ "from": "accumulation", "to": "breakout", "ts": 1710850000 },
{ "from": "breakout", "to": "late_cycle_divergence", "ts": 1710915000 }
]
}
/analysis để xác thực giả định chiến lược dựa trên dữ liệu hiệu suất chế độ lịch sử.GET /exchange-health
Trả về trạng thái sức khỏe thời gian thực cho tất cả các sàn giao dịch được giám sát, bao gồm độ trễ, tỷ lệ lỗi và chỉ số dữ liệu lỗi thời. Không yêu cầu xác thực - điểm cuối công khai.
Ví dụ phản hồi
"overall_status": "ok",
"ts": 1710940821,
"exchanges": {
"bybit": { "status": "ok", "latency_ms": 42, "error_rate_1h": 0.0, "last_data_age_s": 18 },
"binance": { "status": "ok", "latency_ms": 38, "error_rate_1h": 0.0, "last_data_age_s": 22 },
"hyperliquid": { "status": "degraded", "latency_ms": 310, "error_rate_1h": 0.04, "last_data_age_s": 95 },
"okx": { "status": "ok", "latency_ms": 55, "error_rate_1h": 0.0, "last_data_age_s": 30 }
}
}
GET /sentiment
Trả về chỉ số Fear & Greed (0-100) thời gian thực được tính toán từ tâm lý phái sinh, hoạt động cá voi, biến động và tín hiệu mạng xã hội. Bao gồm phân tích thành phần và lịch sử 24 giờ để phân tích xu hướng.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboloptional | string | Ký hiệu tài sản. Mặc định: BTC |
Ví dụ phản hồi
"symbol": "BTC",
"score": 72,
"label": "Tham lam",
"components": {
"biến động": 65,
"đà tăng": 78,
"phái sinh": 70,
"hoạt động cá voi": 75,
"mạng xã hội": 68
},
"lịch sử_24h": [
{ "ts": 1710940800, "score": 68, "label": "Tham lam" },
{ "ts": 1710937200, "score": 65, "label": "Tham lam" }
],
"ts": 1710940821
}
Tích hợp
GET /tradingview/setup
Trả về thiết lập tích hợp TradingView cá nhân của bạn: URL webhook, bí mật xác thực và chỉ báo Pine Script sẵn sàng sử dụng kết nối trực tiếp với Smart Money API. Sao chép-dán Pine Script vào TradingView để hiển thị tín hiệu của chúng tôi trên bất kỳ biểu đồ nào.
Ví dụ phản hồi
"webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
"webhook_secret": "tvs_a1b2c3...",
"pine_scripts": {
"composite_indicator": "// Smart Money Composite v1 //@version=5 indicator(...)...",
"whale_activity": "// Whale Activity Overlay v1 ...",
"funding_dashboard": "// Funding Rate + LSR Dashboard v1 ..."
}
}
POST /tradingview/webhook
Nhận cảnh báo từ TradingView, chạy nó qua /confirm, và trả về xác nhận. TradingView không thể gửi tiêu đề tùy chỉnh, vì vậy hãy xác thực bằng cách bao gồm webhook của bạn secret trong phần thân JSON (endpoint này không sử dụng X-API-Key). Phản hồi bao gồm xác nhận và thêm một action của CONFIRMED (độ tin cậy daemon CAO/TRUNG BÌNH) hoặc VETOED.
Thân yêu cầu
"secret": "your_webhook_secret",
"symbol": "BTC",
"direction": "long",
"timeframe": "1h",
"strategy": "EMA crossover",
"price": 67500.0
}
Yêu cầu: secret, symbol, direction (long|short). Tùy chọn: source, timeframe, strategy, price.
Cá nhân hóa
GET /preferences
Trả về cài đặt cá nhân hóa hiện tại của bạn bao gồm thông số giao dịch mặc định, hồ sơ rủi ro, danh sách theo dõi và tùy chọn thông báo.
Cập nhật tùy chọn bằng cách gửi thân JSON với bất kỳ tập hợp con nào của các trường bên dưới. Các trường bị bỏ qua giữ nguyên giá trị hiện tại.
Trường tùy chọn
| Trường | Loại | Mô tả |
|---|---|---|
| default_trade_size_usd | float | Kích thước vị trí mặc định bằng USD cho tính toán Kelly và smart-stop |
| risk_tolerance | string | conservative, moderate, hoặc aggressive |
| default_risk_pct | float | Rủi ro mặc định mỗi giao dịch tính bằng % tài khoản. Được sử dụng bởi /smart-stop khi risk_pct bị bỏ qua |
| watchlist | array | Danh sách sắp xếp các ký hiệu tài sản, ví dụ ["BTC","ETH","SOL"] |
| notification_email | string | Địa chỉ email để nhận cảnh báo |
| timezone | string | Chuỗi múi giờ IANA, ví dụ America/New_York |
"default_trade_size_usd": 5000,
"risk_tolerance": "moderate",
"default_risk_pct": 1.5,
"watchlist": ["BTC", "ETH", "SOL"]
}
GET /watchlist
Trả về trạng thái xác nhận và các chỉ số rủi ro chính cho tất cả các biểu tượng trong danh sách theo dõi đã cấu hình. Cung cấp cái nhìn tổng quan đa tài sản mà không cần gọi /confirm riêng lẻ cho từng biểu tượng.
Ví dụ phản hồi
"ts": 1710940821,
"watchlist": [
{
"symbol": "BTC",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "accumulation",
"cascade_risk": "LOW"
},
{
"symbol": "ETH",
"confidence": "MEDIUM",
"action": "REDUCE",
"regime": "late_cycle_divergence",
"cascade_risk": "HIGH"
},
{
"symbol": "SOL",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "breakout",
"cascade_risk": "MEDIUM"
}
]
}
Phát trực tiếp thời gian thực (Giao dịch hoán đổi trực tiếp)
Phát trực tiếp các giao dịch hoán đổi DEX ≥ $500 được phát hiện trong thời gian thực từ các nút BSC và Avalanche của chúng tôi. Có hai phương thức truyền tải: một luồng Server-Sent Events (SSE) công khai miễn phí/cho trình duyệt và một luồng WebSocket tốc độ cao cho các gói trả phí. Sự kiện được phát trong vòng vài giây sau khi được đưa vào một khối.
Luồng SSE công khai (Miễn phí)
Không yêu cầu xác thực. Hỗ trợ EventSource tích hợp trên mọi trình duyệt hiện đại. Máy chủ phát ra swap sự kiện và các tín hiệu heartbeat định kỳ để duy trì kết nối.
es.addEventListener("swap", e => {
const swap = JSON.parse(e.data);
console.log(swap.chain, swap.pair, swap.amount_usd);
});
WebSocket Firehose (Trả phí)
Xác thực (khuyến nghị): không bao giờ đặt khóa dài hạn của bạn vào URL — nó sẽ bị ghi lại bởi proxy và lưu trong lịch sử trình duyệt. Thay vào đó, hãy POST khóa của bạn tới /v1/ws/ticket sử dụng X-API-Key header an toàn, sau đó mở kết nối với ticket (có hiệu lực ~60s, chỉ sử dụng một lần). Các máy khách phía máy chủ có thể đặt header có thể truyền X-API-Key trực tiếp trong quá trình bắt tay. Các khóa miễn phí nhận được 402 payment_required phản hồi. Một hello frame được gửi khi kết nối với gói của bạn và ngưỡng phát sóng.
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. Mở kết nối với vé sử dụng một lần
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
const swap = JSON.parse(e.data);
if (swap.type === "swap") console.log(swap);
};
Xác thực WebSocket (vé)
Tại sao: không bao giờ đặt khóa API của bạn vào URL WebSocket — chuỗi truy vấn bị ghi lại bởi proxy, bộ cân bằng tải và lưu trong lịch sử trình duyệt. Thay vào đó, hãy đổi khóa của bạn lấy một ticket ngắn hạn, sử dụng một lần thông qua POST xác thực thông thường, sau đó kết nối bằng vé đó.
Quy trình: POST tới /v1/ws/ticket với X-API-Key header của bạn → nhận { "ticket": "…", "expires_in": 60 }. Sau đó mở wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. Vé là sử dụng một lần và hết hạn sau ~60 giây. Các máy khách phía máy chủ có thể thiết lập tiêu đề yêu cầu có thể thay thế bằng cách chuyển X-API-Key trực tiếp trên bắt tay WebSocket — không cần vé.
Tạo một vé một lần cho một bắt tay WebSocket đã xác thực. Xác thực với X-API-Key tiêu đề (khóa của bạn không bao giờ rời khỏi tiêu đề yêu cầu). Vé được trả về có thể được sử dụng một lần trên /v1/ws/live-swaps trước khi nó hết hạn.
"https://api.smartmoneyapi.com/v1/ws/ticket"
Ví dụ Phản hồi
"ticket": "wst_9f3c1a8e4b2d…",
"expires_in": 60
}
Các Trường Phản hồi
| Trường | Loại | Mô tả |
|---|---|---|
| ticket | string | Token sử dụng một lần để thêm vào ?ticket= trên URL WebSocket. Được sử dụng một lần, sau đó bị vô hiệu hóa. |
| expires_in | number | Số giây cho đến khi vé hết hạn (~60). Tạo một vé mới cho mỗi lần thử kết nối. |
Lưu ý: cách xác thực truyền thống ?key= thông qua tham số truy vấn không còn được chấp nhận trên các điểm cuối WebSocket vì lý do bảo mật. Sử dụng vé (cho máy khách trình duyệt) hoặc X-API-Key tiêu đề bắt tay (cho máy khách phía máy chủ).
Ảnh chụp nhanh REST
Trả về N giao dịch hoán đổi được phát sóng gần đây nhất từ bộ đệm lăn. Hữu ích cho việc hiển thị ban đầu trên bảng điều khiển trước khi kết nối luồng mở. Cũng có sẵn: /v1/live-swaps/status cho thống kê người phát sóng.
Sự kiện Schema
| Trường | Loại | Mô tả |
|---|---|---|
| chain | string | bsc hoặc avalanche |
| dex | string | Tên bộ định tuyến (ví dụ: pancakeswap_v2, traderjoe) hoặc unknown_dex |
| swapper | string | Địa chỉ ví 0x đầy đủ của ví đã thực hiện giao dịch hoán đổi |
| swapper_short | string | Dạng viết tắt để hiển thị (ví dụ: 0xb300…028d) |
| swapper_url | string | Liên kết trực tiếp đến người hoán đổi trên trình khám phá khối của chuỗi |
| tx_hash | string | Hash giao dịch |
| explorer_url | string | Liên kết trực tiếp đến giao dịch trên BscScan / Snowtrace |
| token_in | string | Ký hiệu của token được bán (ví dụ: USDT) |
| token_out | string | Ký hiệu của token được mua |
| amount_usd | number | Giá trị USD của giao dịch hoán đổi (tối thiểu: $500) |
| pair | string | Nhãn cặp được định dạng (ví dụ: USDT → USDC) |
| block | number | Số khối nơi giao dịch hoán đổi được đào |
| timestamp | number | Thời gian Unix epoch tính bằng giây |
| significance | string | low / medium / high / critical dựa trên kích thước USD |
| seq | number | Số thứ tự phát sóng đơn điệu — sử dụng để phát hiện khoảng trống |
POST /alerts/conditions
Tạo các quy tắc cảnh báo tùy chỉnh được kích hoạt khi một chỉ số cụ thể vượt qua ngưỡng. Cảnh báo được gửi qua webhook, email hoặc nguồn thông báo trên bảng điều khiển tùy thuộc vào sở thích của bạn.
Trả về danh sách tất cả các điều kiện cảnh báo đã cấu hình của bạn cùng với ID, định nghĩa và trạng thái hiện tại của chúng.
Xóa vĩnh viễn một điều kiện cảnh báo bằng ID của nó.
Trả về các sự kiện kích hoạt cảnh báo gần đây với dấu thời gian, điều kiện khớp và giá trị chỉ số tại thời điểm kích hoạt.
Tạo Cảnh báo — Thân Yêu cầu
| Trường | Loại | Mô tả |
|---|---|---|
| namerequired | string | Nhãn dễ đọc cho cảnh báo này (tối đa 64 ký tự) |
| metricrequired | string | Chỉ số cần theo dõi. Xem bảng chỉ số khả dụng bên dưới. |
| symboloptional | string | Ngữ cảnh tài sản. Bắt buộc cho các chỉ số phạm vi symbol như funding_rate. |
| operatorrequired | string | Toán tử so sánh: gt, lt, eq, crosses_above, crosses_below |
| thresholdrequired | float | Giá trị số để so sánh với chỉ số |
| deliveryoptional | string | Kênh phân phối, ví dụ: telegram (mặc định) hoặc webhook |
| cooldown_minutesoptional | integer | Số phút tối thiểu giữa các lần kích hoạt lại (mặc định 60) |
Danh sách các chỉ số và toán tử hợp lệ được trả về bởi GET /v1/alerts/conditions as available_metrics and available_operators.
Các Chỉ Số Khả Dụng
| Chỉ Số | Mô Tả |
|---|---|
| funding_rate | Tỷ lệ funding hiện tại cho symbol (dưới dạng thập phân) |
| global_lsr | Tỷ lệ long/short toàn cầu cho symbol |
| long_pct | Phần trăm tài khoản đang long cho symbol |
| top_trader_lsr | Tỷ lệ long/short của top trader cho symbol |
| taker_ratio | Tỷ lệ mua/bán của taker cho symbol |
| mvrv | Tỷ lệ Giá Trị Thị Trường trên Giá Trị Thực (BTC/ETH) |
| sopr | Tỷ Lệ Lợi Nhuận Đầu Ra Đã Tiêu (BTC/ETH) |
| exchange_net_flow | Tín hiệu dòng chảy ròng trên sàn giao dịch on-chain |
| accumulation | Tín hiệu tích lũy on-chain |
| whale_long_pct | Phần trăm ví cá voi được theo dõi đang giữ vị thế long cho symbol |
| whale_n_wallets | Số lượng ví cá voi được theo dõi có vị thế trong symbol |
| composite_long | Điểm tổng hợp cho symbol được truy vấn theo hướng long |
| composite_short | Điểm tổng hợp cho symbol được truy vấn theo hướng short |
| funding_spread | Chênh lệch funding giữa các sàn cho symbol |
"name": "BTC funding rate spike",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}
GET /kelly
Trả về khuyến nghị định cỡ vị thế theo Tiêu Chí Kelly được hiệu chỉnh theo hiệu suất tín hiệu lịch sử cho symbol, mức độ tin cậy và hướng. Căn cứ kích thước vị thế vào tỷ lệ thắng thực nghiệm để tránh đòn bẩy quá mức.
Parameters
| Parameter | Type | Description |
|---|---|---|
| symbolrequired | string | Ký hiệu tài sản: BTC, ETH, hoặc SOL |
| confidenceoptional | string | Mức độ tin cậy của tín hiệu để mô hình hóa: HIGH, MEDIUM, hoặc LOW. Mặc định: HIGH |
| directionoptional | string | Hướng giao dịch: long hoặc short. Mặc định: long |
| account_sizeoptional | float | Kích thước tài khoản bằng USD để tính toán suggested_size_usd. Mặc định: 10000 |
Example Response
"symbol": "BTC",
"confidence": "HIGH",
"direction": "long",
"win_rate": 0.68,
"avg_reward_risk_ratio": 2.1,
"kelly_fraction": 0.36,
"half_kelly": 0.18,
"suggested_size_usd": 1800,
"samples": 142,
"note": "Half-Kelly được khuyến nghị cho giao dịch thực tế để tính đến sai số ước lượng."
}
GET /performance
Trả về thống kê độ chính xác lịch sử của các tín hiệu được phát hành bởi API, phân loại theo mức độ tin cậy. Hữu ích để đánh giá độ tin cậy của tín hiệu trước khi cam kết vốn.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| symboltùy chọn | string | Lọc theo tài sản. Bỏ trống để lấy thống kê tổng hợp trên tất cả các symbol. |
| daystùy chọn | integer | Cửa sổ thời gian tra cứu ngược (ngày). Mặc định: 30 |
Ví dụ phản hồi
"symbol": "BTC",
"period_days": 30,
"by_confidence": {
"HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
"MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
}
}
Thống kê & Tín hiệu
GET /v1/stats
Thống kê hiệu suất minh bạch toàn trang được lấy từ smart_money_confirm kết quả cuộc gọi riêng biệt. Trả về tỷ lệ thắng ở các mức độ tin cậy CAO và TRUNG BÌNH, độ chính xác tổng thể, hệ số lợi nhuận và phân tích chi tiết theo symbol. Tất cả số liệu đều là in-sample trong cửa sổ đánh giá; tham khảo calibration.html để biết bối cảnh và phương pháp luận forward-holdout.
Ví dụ phản hồi
"high_winrate": 0.714,
"high_winrate_n": 14,
"medium_winrate": 0.530,
"medium_winrate_n": 34,
"overall_accuracy": 0.613,
"overall_accuracy_n": 48,
"profit_factor": 1.77,
"avg_win_pct": 4.2,
"winrate_horizon": "24h",
"winrate_basis": "distinct confirm calls, 24h resolved outcomes",
"winrate_by_symbol": {
"BTC": { "win_rate": 0.68, "n": 22 },
"ETH": { "win_rate": 0.55, "n": 18 },
"SOL": { "win_rate": 0.60, "n": 8 }
},
"forward_holdout": {
"win_rate": 0.59,
"high_win_rate": 0.70,
"high_n": 10,
"is_distinct_from_insample": false
}
}
forward_holdout là con số duy nhất được tích lũy trên dữ liệu mà bộ tính điểm chưa từng thấy — theo dõi nó tăng trưởng theo thời gian. Xem calibration.html để biết phương pháp luận đầy đủ và ranh giới in-sample / forward-test.GET /v1/signals/performance
Theo dõi kết quả tín hiệu trên nhiều khung thời gian phân giải (4h, 12h, 24h, 72h). Trả về tỷ lệ trúng theo khung thời gian, tổng số tín hiệu và phân tích theo loại tín hiệu.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| daystùy chọn | integer | Cửa sổ thời gian tra cứu ngược (ngày). Mặc định: 30 |
| signal_typetùy chọn | string | Lọc theo loại, ví dụ smart_money_confirm hoặc regime_flip. Bỏ trống để lấy tất cả các loại. |
| symboltùy chọn | string | Lọc theo symbol tài sản, ví dụ BTC. Bỏ trống để lấy tổng hợp trên tất cả các symbol. |
Ví dụ phản hồi
"signal_type": "smart_money_confirm",
"symbol": "BTC",
"days": 30,
"total_signals": 48,
tầm nhìn: {
4h: { tỷ lệ trúng: 0.65, đã giải quyết: 46 },
12h: { tỷ lệ trúng: 0.61, đã giải quyết: 44 },
24h: { tỷ lệ trúng: 0.58, đã giải quyết: 40 },
72h: { tỷ lệ trúng: 0.54, đã giải quyết: 32 }
},
phân loại: {
xác nhận smart_money: { số lượng: 35, tỷ lệ trúng_24h: 0.61 },
đảo chiều chế độ: { số lượng: 13, tỷ lệ trúng_24h: 0.47 }
}
}
GET /v1/signals/recent
Luồng tín hiệu HIGH và MEDIUM được công bố gần đây trên tất cả các cặp được theo dõi. Mỗi mục bao gồm loại tín hiệu, mức độ tin cậy, hướng và trạng thái giải quyết (nếu có).
Ví dụ phản hồi
signals: [
{
id: 1042,
symbol: BTC,
direction: long,
signal_type: smart_money_confirm,
confidence: HIGH,
composite: 0.74,
ts: 1710940821,
resolved: true,
outcome_24h: win
}
],
count: 50
}
GET /v1/signals/{id}/outcome
Kết quả giải quyết của một tín hiệu duy nhất theo ID số. Trả về trúng/trượt ở từng mốc thời gian giải quyết (4h, 12h, 24h, 72h) cùng với giá tại thời điểm tín hiệu và khi giải quyết.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| idbắt buộc | integer | ID tín hiệu (đoạn đường dẫn), ví dụ /v1/signals/1042/outcome |
Ví dụ phản hồi
id: 1042,
symbol: BTC,
direction: long,
confidence: HIGH,
entry_price: 63200.0,
ts: 1710940821,
outcomes: {
4h: { result: win, price: 64100.0, pct: 1.41 },
12h: { result: win, price: 65200.0, pct: 3.16 },
24h: { result: win, price: 65800.0, pct: 4.11 },
72h: { result: pending, price: null, pct: null }
}
}
GET /v1/confirm-winrate
Phân tích tỷ lệ thắng của tín hiệu xác nhận cho khóa API của người dùng. Trả về tỷ lệ thắng theo từng mức độ tin cậy, hệ số lợi nhuận và số liệu theo cặp. Yêu cầu một X-API-Key header.
Ví dụ yêu cầu
"https://api.smartmoneyapi.com/v1/confirm-winrate"
Ví dụ phản hồi
high_winrate: 0.714,
high_n: 14,
medium_winrate: 0.530,
trung bình_n: 34,
độ chính xác tổng thể: 0.613,
tổng số_n: 48,
hệ số lợi nhuận: 1.77,
tỷ lệ thắng theo khung thời gian: 24h,
theo_symbol: {
BTC: { tỷ_lệ_thắng: 0.68, n: 22 },
ETH: { tỷ_lệ_thắng: 0.55, n: 18 }
}
}
Shadow Gate
Một sổ cái quyết định cá nhân chỉ ghi thêm, không thay đổi. Gửi quyết định giao dịch trước hoặc sau khi thực hiện; hệ thống tính điểm xác nhận so với động cơ Smart Money và thêm một hàng vĩnh viễn. Dùng để xây dựng hồ sơ minh bạch, có dấu thời gian về mức độ tín hiệu API phù hợp với điểm vào của bạn — hoàn toàn độc lập với nhóm tỷ lệ thắng toàn cầu. Phản hồi cấp Miễn phí và Trader bị lược bỏ trường bằng chứng; Pro trả về đầy đủ. Dữ liệu cấp Miễn phí áp dụng độ trễ.
Gửi quyết định. Tính bất biến trên Idempotency-Key tiêu đề yêu cầu — gửi lại cùng khóa sẽ trả về hàng hiện có mà không tạo bản sao. Hệ thống ngay lập tức gọi động cơ xác nhận và thêm kết quả vào sổ cái không thay đổi.
Thân yêu cầu
| Trường | Loại | Mô tả |
|---|---|---|
| symbolbắt buộc | chuỗi | Ký hiệu tài sản, ví dụ BTC |
| sidebắt buộc | chuỗi | Hướng giao dịch: long hoặc short |
| strategy_idtùy chọn | chuỗi | Nhãn chiến lược do người gọi định nghĩa (tối đa 64 ký tự). Lưu nguyên để nhóm và lọc. |
Ví dụ yêu cầu
-H "X-API-Key: sm_your_key" \
-H "Idempotency-Key: my-signal-20260701-001" \
-H "Content-Type: application/json" \
-d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
"https://api.smartmoneyapi.com/v1/shadow-gate/decisions"
Ví dụ phản hồi
"id": 318,
"symbol": "BTC",
"side": "long",
"strategy_id": "ema_crossover",
"decision": "CONFIRM",
"confidence": "HIGH",
"composite": 0.74,
"size_mult": 1.5,
"ts": 1710940821,
"resolved": false
}
factors / adjustments trường bằng chứng. Pro trả về đầy đủ. Cấp Miễn phí áp dụng độ trễ — hàng được ghi ngay nhưng điểm xác nhận có thể phản ánh dữ liệu cache cũ đến 60 giây.Liệt kê quyết định shadow-gate của bạn, mới nhất trước. Phạm vi chủ sở hữu — chỉ trả về quyết định từ khóa API của bạn.
Tham số
| Tham số | Loại | Mô tả |
|---|---|---|
| limittùy chọn | số nguyên | Số hàng tối đa trả về. Mặc định: 50, tối đa: 200 |
| cursortùy chọn | chuỗi | Con trỏ phân trang không rõ ràng từ trường next_cursor của phản hồi trước. Bỏ qua cho trang đầu. |
Ví dụ phản hồi
"decisions": [
{ "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
{ "id": 317, "symbol": "ETH", "side": short, quyết định: SKIP, độ tin cậy: LOW, tổng hợp: -0.12, size_mult: 0.0, ts: 1710937000, đã giải quyết: True }
],
số lượng: 2,
next_cursor: None
}
Quyết định đơn lẻ theo ID, bao gồm đầy đủ bằng chứng xác nhận cho gói Pro. Các phản hồi từ gói Free và Trader sẽ bị factors và adjustments loại bỏ. Trả về 403 nếu quyết định thuộc về một API key khác.
Ví dụ phản hồi (Pro)
id: 318,
symbol: BTC,
side: long,
strategy_id: ema_crossover,
decision: CONFIRM,
confidence: HIGH,
composite: 0.74,
size_mult: 1.5,
factors: {
derivatives: { score: 0.81, weight: 0.40, weighted: 0.324 },
onchain: { score: 0.68, weight: 0.35, weighted: 0.238 },
whale: { score: 0.73, weight: 0.25, weighted: 0.183 }
},
ts: 1710940821,
resolved: False,
outcome: None
}
Giải quyết thủ công kết quả của một quyết định. Gọi phương thức này sau khi đóng giao dịch để ghi lại kết quả cuối cùng vào bảng ghi. Một khi đã được giải quyết, bản ghi sẽ không thể thay đổi lại.
Request Body
| Trường | Loại | Mô tả |
|---|---|---|
| outcomebắt buộc | chuỗi | Kết quả giao dịch: win hoặc loss |
| exit_pricetùy chọn | float | Giá thoát lệnh. Được lưu để tham khảo; sử dụng để tính toán % P&L nếu được cung cấp. |
| pnl_pcttùy chọn | float | P&L thực tế dưới dạng phần trăm kích thước vị thế, ví dụ 3.5 hoặc -1.2 |
Ví dụ phản hồi
id: 318,
resolved: True,
outcome: win,
exit_price: 65800.0,
pnl_pct: 4.1,
resolved_at: 1711027200
}
Mã lỗi
| Trạng thái | Mã | Mô tả |
|---|---|---|
| 400 | invalid_params | Thiếu hoặc tham số truy vấn không hợp lệ |
| 401 | unauthorized | Thiếu hoặc API key không hợp lệ |
| 403 | plan_restriction | Endpoint không khả dụng trong gói hiện tại của bạn |
| 429 | rate_limit_exceeded | Đạt giới hạn hàng ngày hoặc giới hạn tức thời |
| 500 | internal_error | Lỗi máy chủ — kiểm tra /health để biết trạng thái nguồn |
| 503 | data_stale | Nguồn dữ liệu không khả dụng; trả về dữ liệu đã biết gần nhất |
Ví dụ mã
Python
r = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": "BTC", "direction": "long"},
headers={X-API-Key: sm_your_key}
)
data = r.json()
print(data["confidence"]) # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0
API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"
def confirm_trade(symbol, direction):
resp = requests.get(
f"{BASE_URL}/confirm",
params={"symbol": symbol, "direction": direction},
headers={"X-API-Key": API_KEY},
timeout=5
)
resp.raise_for_status()
return resp.json()
# Trong vòng lặp giao dịch của bạn:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
print("Bỏ qua — độ tin cậy không đủ")
else:
size = base_size * signal["size_mult"]
place_order(symbol, direction, size)
JavaScript / Node.js
async function confirmTrade(symbol, direction) {
const params = new URLSearchParams({ symbol, direction });
const res = await fetch(
`https://api.smartmoneyapi.com/v1/confirm?${params}`,
{ headers: { 'X-API-Key': API_KEY } }
);
if (!res.ok) throw new Error(`API error: ${res.status}`);
return res.json();
}
// Cách sử dụng
confirmTrade('BTC', 'long')..then(data => {
console.log(data.confidence, data.size_mult);
});
cURL
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
# Lấy dữ liệu cá voi
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/whales?symbol=BTC"
# Kiểm tra sử dụng
curl -X GET \
-H X-API-Key: sm_your_key \
https://api.smartmoneyapi.com/v1/usage
Tích hợp Freqtrade
Thêm xác nhận Smart Money vào bất kỳ chiến lược Freqtrade nào bằng cách ghi đè confirm_trade_entry phương thức.
from freqtrade.strategy import IStrategy
class SmartMoneyStrategy(IStrategy):
SM_API_KEY = "sm_your_key"
SM_BASE = "https://api.smartmoneyapi.com/v1"
def confirm_trade_entry(self, pair, order_type,
amount, rate, time_in_force,
current_time, entry_tag, **kwargs):
symbol = pair.split("/")[0]
if symbol not in ["BTC", "ETH", "SOL"]:
return True # Bỏ qua kiểm tra cho các cặp không hỗ trợ
try:
r = requests.get(
f"{self.SM_BASE}/confirm",
params={"symbol": symbol, "direction": "long"},
headers={"X-API-Key": self.SM_API_KEY},
timeout=3
).json()
return r.get("confidence") in ["HIGH", "MEDIUM"]
except:
return True # Mở lỗi khi API gặp sự cố
CCXT + Smart Money
exchange = ccxt.bybit({
"apiKey": "YOUR_BYBIT_KEY",
"secret": "YOUR_BYBIT_SECRET"
})
SM_KEY = "sm_your_key"
def smart_trade(symbol, side, amount):
# Kiểm tra xác nhận trước
conf = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": symbol, "direction": side},
headers={"X-API-Key": SM_KEY}
).json()
if conf["confidence"] not in ["HIGH", "MEDIUM"]:
print(f"Bỏ qua {symbol} {side} — độ tin cậy không đủ.")
return None
adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"Đã đặt lệnh: {adj_amount} {symbol} {side}")
return order
Kiểm tra trang trạng thái API để xem thông tin sức khỏe thời gian thực hoặc sử dụng biểu mẫu liên hệ.