{"service":"x402.tunedfor.ai","version":"1.0","status":"live","notice":"Live data pipeline. All prices in USDC. Data is for informational purposes only.","endpoints":[{"method":"POST","path":"/data","price":"0.20","tokens_supported":17,"description":"Curated crypto market snapshot - core Pillar fields, no LLM. Nulls propagate honestly when an upstream API is unavailable - no fabricated zeros; check field_ages and coverage for per-field staleness and unsupported fields. Returns: price_usd, change_pct_24h, volume_24h_usd_primary_venue, market_cap_usd, funding_rate, open_interest_usd, cvd_1h, buy_ratio, whale_bar_count_1h, liquidation_buy_1h, liquidation_sell_1h, cvd_divergence, spot_perp_delta, volume_herfindahl, fear_greed, fear_greed_label. Does not include directional signals or macro regime - use /analyze/market or /analyze/full for that. Coverage is explicit: ZEC is unsupported for snapshot endpoints; slow/sentiment fields are supported only for the declared Santiment universe. Data freshness: Pillar snapshots refresh every 5 minutes. Server cache TTL: 1 hour (override with max_age_seconds).","coverage_contract":{"token_universe":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","ARB","SUI","OP","LTC","AMP","ZEC"],"required_fields":["token","fetched_at","price_usd","change_pct_24h"],"optional_fields":["volume_24h_usd_primary_venue","market_cap_usd","funding_rate","open_interest_usd","cvd_1h","buy_ratio","whale_bar_count_1h","liquidation_buy_1h","liquidation_sell_1h","cvd_divergence","spot_perp_delta","volume_herfindahl","fear_greed","fear_greed_label","sentiment_positive","sentiment_negative","social_dominance","social_volume"],"provider_dependencies":["Pillar token_snapshots","Coinalyze","aggr-server","Santiment"],"freshness_target":{"target_seconds":300,"cache_ttl_seconds":3600},"unsupported_fields":{"slow_sentiment_universe":["ARB","BCH","DOT","HBAR","LTC","OP","SHIB","TON","TRX","UNI","XLM"]},"commercial_tiers":{"BTC":"deep","ETH":"deep","SOL":"deep","XRP":"deep","ADA":"deep","DOGE":"deep","AVAX":"deep","LINK":"deep","BNB":"deep","ATOM":"deep","DOT":"partial","ARB":"partial","SUI":"deep","OP":"partial","LTC":"partial","AMP":"amp_special","ZEC":"unsupported"}},"use_when":"You want raw data to process yourself, feed into a model, or build derived signals on top of. Not the right call if you need a directional read or regime classification — use /analyze/market or /analyze/full for that.","answers":"What is the exact current market state for this token across all data dimensions?","try_demo":"GET /demo","request_body":{"token":"BTC"},"response_example":{"_schema_note":"Schema-only placeholders. Type names (<float>, <int>, <ISO-8601 UTC>) replace numeric and temporal values — these are NOT live data. Call POST /data for real values. Fields shown match the actual response shape exactly.","schema_version":"<string>","token":"BTC","timestamp":"<ISO-8601 UTC>","snapshot_time":"<ISO-8601 UTC>","snapshot":{"token":"BTC","fetched_at":"<ISO-8601 UTC>","price_usd":"<float>","change_pct_24h":"<float>","volume_24h_usd_primary_venue":"<float>","market_cap_usd":"<float>","funding_rate":"<float>","open_interest_usd":"<float>","cvd_1h":"<float>","buy_ratio":"<float, 0.0-1.0>","whale_bar_count_1h":"<int, 0-12>","liquidation_buy_1h":"<float>","liquidation_sell_1h":"<float>","cvd_divergence":"<float>","spot_perp_delta":"<float>","volume_herfindahl":"<float, 0.0-1.0>","fear_greed":"<int, 0-100>","fear_greed_label":"<string, enum>"},"data_freshness":{"data_age_seconds":"<int>","stale":"<bool>"},"coverage":"<coverage metadata object>","field_ages":"<dict[str, int] | null — only carried-forward fields appear>"}},{"method":"POST","path":"/data/light","price":"0.05","tokens_supported":"any-token (long tail)","coverage_contract":{"token_universe":["any_coingecko_resolvable_token"],"required_fields":["response_schema_version","symbol","coingecko_id","name","source","current","data_freshness","data_gaps"],"optional_fields":["momentum","extremes","ranking","project","where_to_trade","community","signals","signals_spec_version","coverage","attribution"],"provider_dependencies":["CoinGecko Pro"],"freshness_target":{"price_target_seconds":300,"project_cache_ttl_seconds":86400,"exchange_cache_ttl_seconds":21600},"unsupported_fields":{},"commercial_tiers":{"any_resolvable_symbol":"standard"}},"description":"Structured any-token coverage. Replaces 3-4 API calls + signal math in one round trip. Returns ~50 fields: current (price, market cap, volume, supply), momentum (1h/24h/7d/14d/30d/1y), extremes (ATH/ATL + drawdown), ranking, project info, exchange listings, community data, and 8 derived signals (momentum_tier, volume_state, volatility_grade, drawdown_phase, liquidity_tier, rank_tier, risk_flags, agent_priority). Data sourced from CoinGecko. MCP adds LLM brief; REST is data-only.","use_when":"You need structured market intelligence for any listed token. One call replaces price lookup + signal computation + risk assessment. For deep orderflow coverage on the 17-token Pillar universe, use POST /data or /analyze/market instead.","answers":"What's going on with this token? Price, momentum, signals, risk, where to trade.","request_body":{"symbol":"PEPE"},"response_example":{"_schema_note":"Schema-only placeholders. Type names replace numeric values. Call POST /data/light for real values.","response_schema_version":"data_light.v2","symbol":"PEPE","coingecko_id":"<string>","name":"<string>","source":"coingecko","attribution":"Powered by CoinGecko","current":{"price_usd":"<float>","market_cap_usd":"<float>","volume_24h_usd":"<float>","circulating_supply_pct":"<float>"},"momentum":{"change_pct_24h":"<float>","change_pct_7d":"<float>","change_pct_30d":"<float>"},"extremes":{"ath_usd":"<float>","ath_drawdown_pct":"<float>"},"ranking":{"market_cap_rank":"<int>","rank_tier":"<string>"},"signals":{"momentum_tier":"<string>","volume_state":"<string>","agent_priority":"<string>","risk_flags":"<list[string]>"},"signals_spec_version":"2026-05-04","coverage":"anytoken_enriched","data_gaps":[{"field":"<string>","reason":"<string>"}]}},{"method":"POST","path":"/analyze/market","price":"0.25","tokens_supported":17,"coverage_contract":{"token_universe":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","ARB","SUI","OP","LTC","AMP","ZEC"],"required_fields":["price_usd"],"optional_fields":["price_change_24h","pulse_signal","signal_confidence","pillar_coverage","macro_regime","macro_context","is_carry_forward"],"provider_dependencies":["Pillar token_snapshots","Trading signals","Trading macro_context"],"freshness_target":{"target_seconds":300,"cache_ttl_seconds":3600},"unsupported_fields":{"slow_sentiment_universe":["ARB","BCH","DOT","HBAR","LTC","OP","SHIB","TON","TRX","UNI","XLM"]},"commercial_tiers":{"BTC":"deep","ETH":"deep","SOL":"deep","XRP":"deep","ADA":"deep","DOGE":"deep","AVAX":"deep","LINK":"deep","BNB":"deep","ATOM":"deep","DOT":"partial","ARB":"partial","SUI":"deep","OP":"partial","LTC":"partial","AMP":"amp_special","ZEC":"unsupported"}},"description":"Pre-trade macro intelligence. Data-only, no LLM. Returns: price_usd, price_change_24h, pulse_signal (up/down), signal_confidence (0.0-1.0), pillar_coverage (which of 4 Pulse pillars contributed to the composite — price/onchain/sentiment/orderflow — plus data_quality 0-1 and degraded bool; added 2026-04-18), macro_regime (bull/bear/risk_on/risk_off/choppy), macro_context (dxy, vix, treasury_10y, fear_greed_score, fear_greed_label), is_carry_forward (bool; TRUE when macro snapshot carried forward from prior trading day — discount regime claims accordingly; added 2026-04-18). Pillar scores (price_score, onchain_score, sentiment_score, orderflow_score, composite_score) are INVERTED percentile rankings: 0.0 = strongly bullish, 1.0 = strongly bearish. A score of 0.2 = metric at 80th percentile (bearish extreme). Add context='7d' for percentile rankings vs the last 7 days for all key fields. 17 tokens: BTC ETH SOL XRP ADA DOGE AVAX LINK BNB ATOM DOT ARB SUI OP LTC AMP ZEC (ZEC unsupported on snapshot-backed endpoints).","use_when":"Before any position decision — check if macro regime and directional momentum are aligned.","answers":"Is the macro environment aligned for this trade?","try_demo":"GET /demo","request_body":{"token":"BTC","depth":"full"},"response_example":{"_schema_note":"Schema-only placeholders. Type names (<float>, <int>, <ISO-8601 UTC>) replace numeric and temporal values — these are NOT live data. Call POST /analyze/market for real values.","schema_version":"<string>","token":"BTC","timestamp":"<ISO-8601 UTC>","snapshot_time":"<ISO-8601 UTC>","price_usd":"<float>","price_change_24h":"<float>","pulse_signal":"<string, enum: up|down>","signal_confidence":"<float, 0.0-1.0>","pillar_coverage":{"pillars_available":"<list[string], subset of {price, onchain, sentiment, orderflow}>","data_quality":"<float, 0.0-1.0>","degraded":"<bool>"},"macro_regime":"<string, enum: bull|bear|choppy|risk_on|risk_off>","macro_context":{"dxy":"<float>","vix":"<float>","treasury_10y":"<float>","fear_greed_score":"<int, 0-100>","fear_greed_label":"<string, enum>"},"is_carry_forward":"<bool | null>","data_freshness":{"stale":"<bool>"},"coverage":"<coverage metadata object>"}},{"method":"POST","path":"/analyze/orderflow","price":"0.50","tokens_supported":26,"coverage_contract":{"token_universe":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","NEAR","ARB","SUI","OP","LTC","TRX","BCH","SHIB","HBAR","TON","XLM","UNI","AAVE","AMP","ZEC"],"required_fields":["cvd_value_usd"],"optional_fields":["buy_ratio","whale_bar_count_1h","liquidation_buy_1h","liquidation_sell_1h","cvd_divergence","spot_perp_delta","volume_herfindahl","exchange_breakdown"],"provider_dependencies":["aggr-server InfluxDB","Pillar token_snapshots"],"freshness_target":{"target_seconds":300,"cache_ttl_seconds":3600},"unsupported_fields":{"thin_exchange_coverage_tokens":["ARB","BCH","DOT","HBAR","LTC","OP","SHIB","TON","TRX","UNI","XLM"]},"commercial_tiers":{"BTC":"standard","ETH":"standard","SOL":"standard","XRP":"standard","ADA":"standard","DOGE":"standard","AVAX":"standard","LINK":"standard","BNB":"standard","ATOM":"standard","DOT":"partial","NEAR":"standard","ARB":"partial","SUI":"standard","OP":"partial","LTC":"partial","TRX":"partial","BCH":"partial","SHIB":"partial","HBAR":"partial","TON":"partial","XLM":"partial","UNI":"partial","AAVE":"standard","AMP":"amp_special","ZEC":"partial"}},"description":"Cross-exchange orderflow verification across 20 exchanges. Data-only, no LLM. Returns: cvd_direction, cvd_value_usd (USD-notional cumulative delta), buy_ratio, whale_bar_count_1h (count of 5-min bars with institutional-sized orders, 0-12), liquidation_buy_1h, liquidation_sell_1h, cvd_divergence (spot CVD vs perp CVD — positive = spot leading, signals imminent move), spot_perp_delta (positive = spot buying ahead of perp), volume_herfindahl HHI (above 0.6 = manipulation risk), exchange_breakdown (exchanges_accumulating, exchanges_distributing, exchanges_total, dominant_direction, diverging_exchanges[]). Add context='7d' for historical percentile rankings. 26 tokens: BTC ETH SOL XRP ADA DOGE AVAX LINK BNB ATOM DOT NEAR ARB SUI OP LTC TRX BCH SHIB HBAR TON XLM UNI AAVE AMP ZEC. Data freshness: orderflow aggregated every 5 minutes from live exchange feeds.","use_when":"Before executing any trade — verify that price action is backed by real cross-exchange volume, not a thin-book squeeze.","answers":"Is this price move backed by real cross-exchange volume or is it manipulation?","try_demo":"GET /demo","request_body":{"token":"ETH","depth":"full"},"response_example":{"_schema_note":"Schema-only placeholders. Type names (<float>, <int>, <ISO-8601 UTC>) replace numeric and temporal values — these are NOT live data. Call POST /analyze/orderflow for real values.","schema_version":"<string>","token":"ETH","timestamp":"<ISO-8601 UTC>","snapshot_time":"<ISO-8601 UTC>","cvd_direction":"<string, enum: up|down|balanced>","cvd_value_usd":"<float>","whale_bar_count_1h":"<int, 0-12>","liquidation_buy_1h":"<float>","liquidation_sell_1h":"<float>","buy_ratio":"<float, 0.0-1.0>","cvd_divergence":"<float>","spot_perp_delta":"<float>","volume_herfindahl":"<float, 0.0-1.0>","exchange_breakdown":{"exchanges_accumulating":"<int>","exchanges_distributing":"<int>","exchanges_total":"<int>","dominant_direction":"<string, enum: buy|sell|balanced>","diverging_exchanges":"<list[string]>"},"data_freshness":{"stale":"<bool>"},"coverage":"<coverage metadata object>"}},{"method":"POST","path":"/analyze/full","price":"0.75","tokens_supported":17,"coverage_contract":{"token_universe":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","ARB","SUI","OP","LTC","AMP","ZEC"],"required_fields":["price_usd"],"optional_fields":["price_change_24h","pulse_signal","signal_confidence","pillar_coverage","macro_regime","macro_context","is_carry_forward","buy_ratio","whale_bar_count_1h","liquidation_buy_1h","liquidation_sell_1h","cvd_divergence","spot_perp_delta","volume_herfindahl","exchange_breakdown","stance","orderflow_signal","risk_level","warnings","verdict","synthesis_model"],"provider_dependencies":["Pillar token_snapshots","Trading signals","Trading macro_context","aggr-server InfluxDB","Moonshot Kimi"],"freshness_target":{"target_seconds":300,"cache_ttl_seconds":3600},"unsupported_fields":{"slow_sentiment_universe":["ARB","BCH","DOT","HBAR","LTC","OP","SHIB","TON","TRX","UNI","XLM"]},"commercial_tiers":{"BTC":"deep","ETH":"deep","SOL":"deep","XRP":"deep","ADA":"deep","DOGE":"deep","AVAX":"deep","LINK":"deep","BNB":"deep","ATOM":"deep","DOT":"partial","ARB":"partial","SUI":"deep","OP":"partial","LTC":"partial","AMP":"amp_special","ZEC":"unsupported"}},"description":"Complete pre-trade due diligence in one payment. All data from /analyze/market and /analyze/orderflow plus a single grounded LLM call with everything in context simultaneously. Returns all market and orderflow fields plus: stance (BULLISH/BEARISH/NEUTRAL), orderflow_signal (ACCUMULATION/DISTRIBUTION/NEUTRAL), risk_level (LOW/MODERATE/HIGH/CRITICAL), warnings[] (string array), verdict (one sentence in plain English citing specific values, designed for direct relay to a non-technical user), synthesis_model, pillar_coverage (pillars_available, data_quality, degraded — added 2026-04-18), is_carry_forward (bool; TRUE when macro snapshot carried forward from prior trading day — added 2026-04-18). Pillar scores (price_score, onchain_score, sentiment_score, orderflow_score, composite_score) are INVERTED percentile rankings: 0.0 = strongly bullish, 1.0 = strongly bearish. A score of 0.2 = metric at 80th percentile (bearish extreme). Replaces 3 separate API calls + LLM step. 17 tokens: BTC ETH SOL XRP ADA DOGE AVAX LINK BNB ATOM DOT ARB SUI OP LTC AMP ZEC (ZEC unsupported on snapshot-backed endpoints). Data freshness: same as /analyze/market and /analyze/orderflow — Pillar snapshots every 5 min, orderflow every 5 min.","use_when":"Before any significant trade or when you need a complete situational picture in one call.","answers":"What is the complete market state for this token and what action does the data support?","try_demo":"GET /demo","request_body":{"token":"BTC","depth":"full"},"response_example":{"_schema_note":"Schema-only placeholders. Type names (<float>, <int>, <ISO-8601 UTC>) replace numeric and temporal values — these are NOT live data. Call POST /analyze/full for real values. Verdict is a one-sentence English summary produced by the grounded LLM and cites observed values.","schema_version":"<string>","token":"BTC","timestamp":"<ISO-8601 UTC>","snapshot_time":"<ISO-8601 UTC>","price_usd":"<float>","price_change_24h":"<float>","pulse_signal":"<string, enum: up|down>","signal_confidence":"<float, 0.0-1.0>","pillar_coverage":{"pillars_available":"<list[string], subset of {price, onchain, sentiment, orderflow}>","data_quality":"<float, 0.0-1.0>","degraded":"<bool>"},"macro_regime":"<string, enum: bull|bear|choppy|risk_on|risk_off>","macro_context":"<dict — dxy, vix, treasury_10y, fear_greed_score, fear_greed_label>","is_carry_forward":"<bool | null>","cvd_direction":"<string, enum: up|down|balanced>","cvd_value_usd":"<float>","buy_ratio":"<float, 0.0-1.0>","whale_bar_count_1h":"<int, 0-12>","liquidation_buy_1h":"<float>","liquidation_sell_1h":"<float>","funding_rate":"<float>","open_interest_usd":"<float>","mvrv":"<float | null>","exchange_flow_net":"<float | null>","exchange_flow_direction":"<string | null>","exchange_breakdown":{"exchanges_accumulating":"<int>","exchanges_distributing":"<int>","exchanges_total":"<int>","dominant_direction":"<string, enum: buy|sell|balanced>","diverging_exchanges":"<list[string]>"},"stance":"<string, enum: BULLISH|BEARISH|NEUTRAL>","orderflow_signal":"<string, enum: ACCUMULATION|DISTRIBUTION|NEUTRAL>","risk_level":"<string, enum: LOW|MODERATE|HIGH|CRITICAL>","warnings":"<list[string]>","verdict":"<string — one sentence English summary citing observed values; produced by grounded LLM>","data_freshness":{"stale":"<bool>"},"coverage":"<coverage metadata object>","synthesis_model":"<string — model identifier, e.g. kimi-k2.5>"}},{"method":"POST","path":"/analyze/address","price":"0.25","currency":"USDC","coverage_contract":{"token_universe":["any_evm_address","any_solana_address"],"required_fields":["address","chain","address_type","risk_level"],"optional_fields":["entity_label","is_contract","is_verified","top_tokens","native_balance"],"provider_dependencies":["Blockscout","Helius"],"freshness_target":{"target_seconds":null,"cache_ttl_seconds":86400},"unsupported_fields":{},"commercial_tiers":{"evm":"standard","solana":"standard"}},"description":"On-chain address risk profile. Auto-detects EVM Ethereum (0x...) or Solana (base58). Data-only, no LLM. Returns: address_type (wallet/contract), entity_label if known (e.g. 'Vitalik Buterin', 'Binance 14'), is_contract, is_verified, account_age_days, last_active_days_ago, tx_count, native_balance, top_tokens (top 5 holdings: symbol/balance/value_usd), risk_level (low/medium/high/unknown), flags[]. Risk flags: new_account, low_activity, unverified_contract, dormant, high_throughput. EVM via Blockscout. Solana via Helius.","chains_supported":["evm","solana"],"use_when":"Before interacting with any wallet or contract — profile the address and check risk level first.","answers":"Is this address a wallet or contract? Is it risky? Who owns it and what does it hold?","try_demo":"GET /demo","request_body":{"address":"0x... or base58..."},"response_example":{"_schema_note":"Schema-only placeholders. Type names (<float>, <int>) replace numeric values — these are NOT live data. Call POST /analyze/address with a real address for actual results. The address shown is a real public address (vitalik.eth) used for shape illustration.","schema_version":"<string>","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"<string, enum: evm|solana>","timestamp":"<ISO-8601 UTC>","address_type":"<string, enum: wallet|contract|token|unknown>","is_contract":"<bool>","is_verified":"<bool | null — contracts only>","contract_name":"<string | null — contracts only>","entity_label":"<string | null — known entity name when available>","account_age_days":"<int | null>","last_active_days_ago":"<int | null>","tx_count":"<int | null>","native_balance":"<float | null — ETH or SOL>","top_tokens":"<list[{symbol, balance, value_usd}], up to 5>","risk_level":"<string, enum: low|medium|high|unknown>","flags":"<list[string] — risk flags from {new_account, low_activity, unverified_contract, dormant, high_throughput}>","data_freshness":{"stale":"<bool>"},"coverage":"<coverage metadata object>"}},{"method":"GET","path":"/health","price":"free","description":"Service status + data freshness per source. Check this first to verify the service is alive."},{"method":"GET","path":"/catalog","price":"free","description":"This endpoint. Machine-readable listing with prices, schemas, and example responses."},{"method":"GET","path":"/llms.txt","price":"free","description":"Agent-readable service description with use-case triggers."},{"method":"GET","path":"/demo","price":"free","description":"Free cached example responses for all 6 paid endpoints. Shows exact output schema with realistic field values. Use to validate response format and write integration code before paying. No payment required."},{"method":"GET","path":"/data/coverage","price":"free","description":"JSON coverage matrix. Per-token, per-timeframe historical depth + exchange count + live status. Cached 1h. Use to discover what data is available before calling paid endpoints.","example":"GET /data/coverage"},{"method":"GET","path":"/coverage","price":"free","description":"Human-readable coverage grid rendered as an HTML table. Same data as /data/coverage.","example":"GET /coverage"},{"method":"GET","path":"/.well-known/agent-card.json","price":"free","description":"A2A agent discovery card (Google Agent-to-Agent protocol)."}],"network":"eip155:8453","token_currency":"USDC","token_coverage_notes":{"AMP":"Full coverage + AMP-only whale_net_flow_7d_usd via Dune (not available for other tokens).","ZEC":"Orderflow + history only. /data and /analyze/market may return 'No snapshot data available' — Pillar collection dropped 2026-04-03."}}