API reference overview
Welcome to the ValueScan API documentation. This page lists all public endpoints across token information, fund data, on-chain data, and AI signals for integrating market data, on-chain metrics, AI signals, and more.
Usage notes
Base URL: The full URL for query endpoints is
https://api.valuescan.ai/api+ the path in the table below.SSE / WS subscription endpoints (market analysis subscription / token signal subscription / K-line WS push) use the full URLs listed directly.
Credits: Each call deducts credits as shown below. SSE subscriptions are billed per the corresponding docs; K-line WS push is billed per user — 100 credits every 30 minutes while the WS connection is active.
We continuously add and improve endpoints. Check this documentation regularly.
1. Token information
| Name | Method | Path | Credits |
|---|---|---|---|
| Token list | POST | /open/v1/vs-token/list | 1 |
| Token details | POST | /open/v1/vs-token/detail | 1 |
| K-line data | POST | /open/v1/trade/kline/getTradeKLineList | 2 |
| K-line WS push | GET/WS | wss://stream.valuescan.ai/stream/ws/openapi/kline | 100 credits / 30 min |
2. Fund data
| Name | Method | Path | Credits |
|---|---|---|---|
| Real-time accumulation | POST | /open/v1/trade/getCoinTrade | 4 |
| Fund snapshot | POST | /open/v1/trade/getCoinTradeSnapshot | 4 |
| Sector fund list | POST | /open/v1/trade/categories/getTradeList | 3 |
| Sector token funds | POST | /open/v1/trade/categories/CoinTradeList | 3 |
| Fund / market cap ratio | POST | /open/v1/trade/getCoinTradeInflowMarketCapRatio | 3 |
3. On-chain data
| Name | Method | Path | Credits |
|---|---|---|---|
| Token flow | POST | /open/v1/trade/getCoinTradeFlow | 2 |
| Whale cost trend | POST | /open/v1/trade/getCoinTradeCost | 2 |
| Large transfers | POST | /open/v1/chain/trade/large | 2 |
| Holder addresses | POST | /open/v1/chain/trade/token/holdPage | 2 |
| Balance trend | POST | /open/v1/chain/trade/token/balanceTrend | 2 |
| P&L trend | POST | /open/v1/chain/trade/token/profitLossTrend | 2 |
| Holding cost trend | POST | /open/v1/chain/trade/token/holdTrend | 2 |
| Transaction activity trend | POST | /open/v1/chain/trade/token/tradeCountTrend | 2 |
4. AI signals
| Name | Method | Path | Credits |
|---|---|---|---|
| Support & resistance | POST | /open/v1/indicator/getDenseAreaList | 4 |
| Whale behavior indicator | POST | /open/v1/indicator/getPriceMarketList | 2 |
| Opportunity token list | POST | /open/v1/ai/getChanceCoinList | 6 |
| Opportunity token messages | POST | /open/v1/ai/getChanceCoinMessageList | 5 |
| Risk token list | POST | /open/v1/ai/getRiskCoinList | 6 |
| Risk token messages | POST | /open/v1/ai/getRiskCoinMessageList | 5 |
| Fund anomaly list | POST | /open/v1/ai/getFundsCoinList | 6 |
| Fund anomaly messages | POST | /open/v1/ai/getFundsCoinMessageList | 5 |
| Market analysis subscription (SSE) | GET | https://stream.valuescan.ai/stream/market/subscribe | 50 credits / 30 min |
| New market analysis SSE subscription | GET | https://stream.valuescan.ai/stream/market/analysis/subscribe | 50 credits / 30 min |
| Market analysis list | POST | /open/v1/ai/getMarketAnalysisList | 2 |
| New market analysis list | POST | /open/v1/ai/market-analysis/list | 2 |
| Token signal subscription (SSE) | GET | https://stream.valuescan.ai/stream/signal/subscribe | 50 credits / 30 min |
| Social sentiment | POST | /open/v1/social-sentiment/getCoinSocialSentiment | 2 |