Nansen Score risk and reward indicators for any token via blockchain analytics
What it does
This endpoint returns Nansen Score indicators for a specific token, providing both risk and reward assessments derived from on-chain data. Risk indicators include BTC reflexivity, liquidity risk, concentration risk, and token supply inflation, each scored as low/medium/high. Reward indicators cover chain TVL, trading range, price momentum, chain fees, protocol fees, CEX flows, and funding rate, each scored as bearish/neutral/bullish. Every indicator includes a raw signal value, a percentile rank (0–100) compared to tokens in the same market-cap group, and the date it last changed state.
The endpoint is part of Nansen's Token God Mode (TGM) suite, hosted at `POST /api/v1/tgm/indicators`. It accepts a chain identifier and token contract address in the JSON body. The response also includes token metadata such as market cap, market-cap group classification, and a stablecoin flag. Pricing is $0.05 per call via the x402 protocol (or 50 free-tier credits / 5 pro-tier credits with an API key). The API uses OpenAPI 3.1, returns JSON, and supports standard pagination, rate-limit, and credit-tracking headers.
Nansen covers 25+ chains including Ethereum, Solana, Base, Arbitrum, BNB, Polygon, and others. The broader Nansen API offers smart money tracking, wallet profiling, DEX trade analysis, PnL leaderboards, prediction market analytics, token screening, and an AI research agent — all accessible under the same authentication and payment model.
Capabilities
Use cases
- —Assess risk and alpha potential of a token before trading or investing
- —Screen tokens by risk/reward profile across multiple chains
- —Monitor when a token's risk or reward indicators change state
- —Integrate Nansen Score into automated trading or portfolio management systems
- —Compare a token's metrics against peers in the same market-cap group
Fit
Best for
- —Crypto traders evaluating token risk and momentum signals
- —Portfolio managers needing quantitative on-chain risk scores
- —DeFi researchers analyzing token fundamentals across chains
- —Trading bots that need structured risk/reward data per token
Not for
- —Real-time sub-second price feeds or order execution
- —Non-crypto or traditional equity analysis
- —Free unlimited usage — each call costs $0.05 or credits
Quick start
curl -X POST https://api.nansen.ai/api/v1/tgm/indicators \
-H 'Content-Type: application/json' \
-d '{"chain": "ethereum", "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"}'Example
Request
{
"chain": "ethereum",
"token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
}Response
{
"chain": "ethereum",
"token_info": {
"is_stablecoin": false,
"market_cap_usd": 4690000000,
"market_cap_group": "largecap"
},
"token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
"risk_indicators": [
{
"score": "low",
"signal": 0.75,
"indicator_type": "btc-reflexivity",
"last_trigger_on": "2025-01-15",
"signal_percentile": 85.5
},
{
"score": "medium",
"signal": -0.25,
"indicator_type": "liquidity-risk",
"last_trigger_on": "2025-01-10",
"signal_percentile": 42.3
}
],
"reward_indicators": [
{
"score": "bullish",
"signal": 0.82,
"indicator_type": "price-momentum",
"last_trigger_on": "2025-01-14",
"signal_percentile": 91
}
]
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed endpoint description, request/response models, credit costs, and x402 pricing. The 402 MPP challenge confirms the endpoint is live. No example response was captured from the probe itself, but the schema is comprehensive enough to construct accurate examples. Crawled pages were mostly empty beyond the health check.
Warnings
- —No direct probe response body was captured — liveness inferred from 402 MPP challenge
- —Crawled documentation pages returned 404; all schema info comes from the OpenAPI spec
Citations
- —The /api/v1/tgm/indicators endpoint returns risk indicators (btc-reflexivity, liquidity-risk, concentration-risk, token-supply-inflation) and reward indicators (chain-tvl, trading-range, price-momentum, chain-fees, protocol-fees, cex-flows, funding-rate)https://api.nansen.ai
- —Pricing is $0.05 per call via x402 protocol, or 50 free-tier / 5 pro-tier creditshttps://api.nansen.ai
- —Each indicator includes score, signal, signal_percentile (0-100 vs same market cap group), and last_trigger_onhttps://api.nansen.ai
- —The API supports 25+ chains including ethereum, solana, base, arbitrum, bnb, polygon, and othershttps://api.nansen.ai