{"name":"x402.tunedfor.ai","description":"Machine-actionable market information API for AI agents. Live data from 20 exchanges — not CoinGecko wrappers. /data returns 16 reliable fields at $0.20 for your own models. /analyze/market and /analyze/orderflow return structured market state your code can branch on directly (no LLM). /analyze/full adds a single grounded LLM call that sees everything at once.","version":"1.0.0","homepage":"https://x402.tunedfor.ai","contact":"admin@tunedfor.ai","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"currency":"USDC","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","categories":["crypto","trading","market-structure","orderflow","on-chain-data","risk-scoring"],"tags":["crypto","defi","trading","orderflow","market-structure","on-chain-analytics","risk-scoring","whale-tracking","real-time","multi-exchange","macro","decision-support"],"agentPrompt":"Use this service when your agent needs structured market information. Call /data for the raw market snapshot (16 reliable fields) to feed your own models ($0.20). Call /analyze/market before any position entry to check macro alignment and directional market reading ($0.25). Call /analyze/orderflow to verify whether a price move is backed by real cross-exchange volume or a thin-book squeeze ($0.50). Call /analyze/full for a complete market picture with LLM synthesis — one payment, all data in context simultaneously ($0.75). Call /analyze/address to risk-profile a wallet or contract before interacting with it ($0.25). Call /data/history/1h or /data/history/1d for historical OHLCV + orderflow bars, up to 7 years ($5.00 each).","endpoints":[{"method":"POST","path":"/data","price":"0.20","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","ARB","SUI","OP","LTC"],"description":"Live market snapshot — 16 reliably populated fields only. Price, volume, market cap, derivatives, orderflow, and sentiment. No nulls. Feed into your own models.","agentPrompt":"Call when you want raw market data to process yourself. Returns reliably populated fields only: price_usd, change_pct_24h, volume_24h_usd, 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. All fields have live data — no nulls. Refreshed every 5 minutes. 15 tokens supported.","request_schema":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol (BTC, ETH, SOL, etc.)"},"max_age_seconds":{"type":"integer","description":"Freshness contract. Reject cached data older than this many seconds. Default: server cache TTL (3600s). Set to 0 to force live fetch."}},"required":["token"]},"response_schema":{"type":"object","properties":{"schema_version":{"type":"string"},"token":{"type":"string"},"timestamp":{"type":"string"},"snapshot":{"type":"object","description":"Full raw Pillar snapshot. ~70 fields. Key fields: price_usd, change_pct_24h, volume_24h_usd, market_cap_usd, funding_rate, open_interest_usd, mvrv, active_addresses, exchange_flow_net, cvd_1h, buy_ratio, whale_bar_count_1h, liquidation_buy_1h, liquidation_sell_1h, cvd_divergence, spot_perp_delta, volume_herfindahl."},"data_freshness":{"type":"object","properties":{"data_age_seconds":{"type":"number"},"stale":{"type":"boolean"}}}}},"response_example":{"schema_version":"1.0","token":"BTC","timestamp":"2026-04-08T12:00:00Z","snapshot":{"token":"BTC","fetched_at":"2026-04-08T11:58:22Z","price_usd":84250.0,"change_pct_24h":2.3,"volume_24h_usd":38500000000.0,"market_cap_usd":1660000000000.0,"funding_rate":0.0045,"open_interest_usd":45000000000.0,"mvrv":1.23,"active_addresses":820000,"exchange_flow_net":-12400000.0,"cvd_1h":14523.7,"buy_ratio":0.61,"whale_bar_count_1h":3,"liquidation_buy_1h":12400.0,"liquidation_sell_1h":89200.0,"cvd_divergence":0.14,"spot_perp_delta":0.03,"volume_herfindahl":0.22},"data_freshness":{"data_age_seconds":98,"stale":false}}},{"method":"POST","path":"/analyze/market","price":"0.25","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","ARB","SUI","OP","LTC"],"description":"Pre-trade macro check. Data-only, no LLM. Returns price snapshot, directional market reading with confidence, and macro regime your agent can branch on.","agentPrompt":"Call before any crypto position decision. Returns market_direction ('up'/'down') with confidence (0-1), macro_regime (bull/bear/risk_on/risk_off/choppy), and macro_context (DXY, VIX, fear/greed). Add 'context': '7d' to get percentile rankings — e.g. 'VIX is in the 87th percentile of the last 7 days'. Answers: Is the macro environment aligned for this trade? 15 tokens supported.","request_schema":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol (BTC, ETH, SOL, etc.)"},"depth":{"type":"string","enum":["full","light"],"default":"full"},"context":{"type":"string","description":"Historical context window: '7d' or '30d'. Adds percentile rankings vs historical data."},"max_age_seconds":{"type":"integer","description":"Freshness contract. Reject cached data older than this many seconds. Default: server cache TTL (3600s). Set to 0 to force live fetch."}},"required":["token"]},"response_schema":{"type":"object","properties":{"schema_version":{"type":"string"},"token":{"type":"string"},"timestamp":{"type":"string"},"price_usd":{"type":"number"},"price_change_24h":{"type":"number"},"pulse_signal":{"type":"string","enum":["up","down"],"description":"Directional signal from proprietary composite engine"},"signal_confidence":{"type":"number","minimum":0,"maximum":1},"macro_regime":{"type":"string","description":"bull, bear, choppy, risk_on, or risk_off"},"macro_context":{"type":"object","properties":{"dxy":{"type":"number"},"vix":{"type":"number"},"yield_10y":{"type":"number"},"sp500":{"type":"number"},"fear_greed_score":{"type":"number"},"fear_greed_label":{"type":"string"}}},"historical_context":{"type":"object","description":"Present when context param supplied. Contains percentile rankings for key fields."},"data_freshness":{"type":"object","properties":{"data_age_seconds":{"type":"number"},"stale":{"type":"boolean"},"freshness_warning":{"type":"string"}}}}},"response_example":{"schema_version":"1.1","token":"BTC","timestamp":"2026-04-08T12:00:00Z","price_usd":84250.0,"price_change_24h":2.3,"pulse_signal":"up","signal_confidence":0.72,"macro_regime":"risk_on","macro_context":{"dxy":99.2,"vix":16.8,"yield_10y":4.32,"fear_greed_score":72,"fear_greed_label":"greed"},"data_freshness":{"data_age_seconds":180,"stale":false}}},{"method":"POST","path":"/analyze/orderflow","price":"0.50","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","NEAR","ARB","SUI","OP","LTC","TRX","BCH","SHIB","HBAR","TON","XLM","UNI","AAVE"],"description":"Cross-exchange orderflow verification. Data-only. Returns CVD, whale activity, liquidation pressure, spot/perp delta, and exchange distribution — how many of 20 live venues are accumulating vs distributing.","agentPrompt":"Call when you need to know if a price move is real. Returns cvd_direction, buy_ratio, whale_bar_count_1h, liquidation data, and exchange_breakdown (accumulating vs distributing count across up to 20 exchanges). High volume_herfindahl (>0.6) = manipulation risk. Positive cvd_divergence = spot buyers leading perp — leading indicator. Add 'context': '7d' for historical percentile rankings. Answers: Is this pump backed by real cross-exchange volume, or a thin-book squeeze? 24 tokens supported.","request_schema":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol"},"depth":{"type":"string","enum":["full","light"],"default":"full"},"context":{"type":"string","description":"Historical context window: '7d' or '30d'. Adds percentile rankings."},"max_age_seconds":{"type":"integer","description":"Freshness contract. Reject cached data older than this many seconds."}},"required":["token"]},"response_schema":{"type":"object","properties":{"schema_version":{"type":"string"},"token":{"type":"string"},"timestamp":{"type":"string"},"cvd_direction":{"type":"string","enum":["up","down","balanced"]},"cvd_value":{"type":"number","description":"Cumulative volume delta"},"whale_bar_count_1h":{"type":"integer","description":"Whale-size bars in last hour"},"liquidation_buy_1h":{"type":"number","description":"Long liquidation volume USD (1h)"},"liquidation_sell_1h":{"type":"number","description":"Short liquidation volume USD (1h)"},"buy_ratio":{"type":"number","description":"Buy/sell ratio 0-1. >0.5 = buy dominant."},"cvd_divergence":{"type":"number","description":"Spot CVD minus perp CVD. Positive = spot buyers leading. Leading indicator."},"spot_perp_delta":{"type":"number","description":"Perp price premium/discount to spot."},"volume_herfindahl":{"type":"number","description":"HHI concentration 0-1. >0.6 = manipulation risk."},"exchange_breakdown":{"type":"object","properties":{"exchanges_accumulating":{"type":"integer"},"exchanges_distributing":{"type":"integer"},"exchanges_total":{"type":"integer"},"dominant_direction":{"type":"string","enum":["buy","sell","neutral"]},"diverging_exchanges":{"type":"array","items":{"type":"string"}}}},"historical_context":{"type":"object"},"data_freshness":{"type":"object"}}},"response_example":{"schema_version":"1.1","token":"ETH","timestamp":"2026-04-08T12:00:00Z","cvd_direction":"up","cvd_value":14523.7,"whale_bar_count_1h":3,"liquidation_buy_1h":12400.0,"liquidation_sell_1h":89200.0,"buy_ratio":0.61,"cvd_divergence":0.14,"spot_perp_delta":0.03,"volume_herfindahl":0.22,"exchange_breakdown":{"exchanges_accumulating":14,"exchanges_distributing":6,"exchanges_total":20,"dominant_direction":"buy","diverging_exchanges":[]},"data_freshness":{"data_age_seconds":120,"stale":false}}},{"method":"POST","path":"/analyze/full","price":"0.75","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","ARB","SUI","OP","LTC"],"description":"Complete pre-trade due diligence. All market structure data from /market and /orderflow plus a single grounded LLM call. Returns enumerated stance, orderflow classification, and risk level your agent can switch on.","agentPrompt":"Call before any significant position. One payment covers all data: market regime, cross-exchange orderflow, on-chain funding and MVRV — plus LLM synthesis in one context. Returns stance (BULLISH/BEARISH/NEUTRAL), orderflow_signal (ACCUMULATION/DISTRIBUTION/NEUTRAL), risk_level (LOW/MODERATE/HIGH/CRITICAL), and a verdict sentence citing specific data values. 15 tokens supported.","request_schema":{"type":"object","properties":{"token":{"type":"string"},"context":{"type":"string","description":"Historical context: '7d' or '30d'."},"max_age_seconds":{"type":"integer","description":"Freshness contract."}},"required":["token"]},"response_schema":{"type":"object","properties":{"schema_version":{"type":"string"},"token":{"type":"string"},"timestamp":{"type":"string"},"price_usd":{"type":"number"},"price_change_24h":{"type":"number"},"pulse_signal":{"type":"string","enum":["up","down"]},"signal_confidence":{"type":"number"},"macro_regime":{"type":"string"},"macro_context":{"type":"object"},"cvd_direction":{"type":"string","enum":["up","down","balanced"]},"cvd_value":{"type":"number"},"buy_ratio":{"type":"number"},"whale_bar_count_1h":{"type":"integer"},"liquidation_buy_1h":{"type":"number"},"liquidation_sell_1h":{"type":"number"},"funding_rate":{"type":"number"},"open_interest_usd":{"type":"number"},"mvrv":{"type":"number"},"exchange_breakdown":{"type":"object"},"stance":{"type":"string","enum":["BULLISH","BEARISH","NEUTRAL"]},"orderflow_signal":{"type":"string","enum":["ACCUMULATION","DISTRIBUTION","NEUTRAL"]},"risk_level":{"type":"string","enum":["LOW","MODERATE","HIGH","CRITICAL"]},"warnings":{"type":"array","items":{"type":"string"}},"verdict":{"type":"string","description":"One sentence citing specific data values"},"data_freshness":{"type":"object"}}},"response_example":{"schema_version":"1.1","token":"BTC","timestamp":"2026-04-08T12:00:00Z","price_usd":84250.0,"price_change_24h":2.3,"pulse_signal":"up","signal_confidence":0.72,"macro_regime":"risk_on","macro_context":{"dxy":99.2,"vix":16.8,"fear_greed_score":72,"fear_greed_label":"greed"},"cvd_direction":"up","cvd_value":14523.7,"buy_ratio":0.61,"whale_bar_count_1h":3,"liquidation_buy_1h":12400.0,"liquidation_sell_1h":89200.0,"funding_rate":0.0045,"open_interest_usd":45000000000.0,"mvrv":1.23,"exchange_breakdown":{"exchanges_accumulating":14,"exchanges_distributing":6,"exchanges_total":20,"dominant_direction":"buy","diverging_exchanges":[]},"stance":"BULLISH","orderflow_signal":"ACCUMULATION","risk_level":"LOW","warnings":[],"verdict":"Market stance BULLISH with signal_confidence 0.72. Orderflow ACCUMULATION across 14/20 exchanges. Risk LOW — funding_rate 0.0045 within normal range.","data_freshness":{"data_age_seconds":180,"stale":false}}},{"method":"POST","path":"/analyze/address","price":"0.25","currency":"USDC","description":"On-chain address profile with mechanical risk scoring. Auto-detects EVM (Ethereum mainnet via Blockscout) or Solana (via Helius). Data-only, no LLM.","chains_supported":["evm","solana"],"agentPrompt":"Call when you have an EVM (0x...) or Solana (base58) address and need to know what it is and whether it's risky. Returns address_type (wallet/contract), entity_label if known, tx_count, account_age_days, native_balance, top 5 token holdings, risk_level, and flags. Risk flags: new_account, low_activity, unverified_contract, dormant, high_throughput.","request_schema":{"type":"object","properties":{"address":{"type":"string","description":"EVM address (0x...) or Solana address (base58)"}},"required":["address"]},"response_example":{"schema_version":"1.1","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"evm","address_type":"wallet","entity_label":"Vitalik Buterin","is_contract":false,"native_balance":240.5,"tx_count":1243,"account_age_days":2800,"risk_level":"low","flags":[],"data_freshness":{"stale":false}}},{"method":"POST","path":"/data/history/1h","price":"5.00","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","NEAR","ARB","SUI","OP","LTC","TRX","BCH","SHIB","HBAR","TON","XLM","UNI","AAVE"],"description":"Hourly OHLCV + orderflow bars (vbuy, vsell, cvd, buy_ratio, liquidations). Up to 7 years of history for 24 tokens. Paginate with date ranges.","agentPrompt":"Call for historical hourly bars. Returns OHLCV plus orderflow fields (vbuy, vsell, cvd, buy_ratio, lbuy, lsell). Up to 7 years of history (61,320+ bars). Paginate with start/end date params.","request_schema":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol (BTC, ETH, SOL, etc.)"},"start":{"type":"string","description":"Start date (YYYY-MM-DD). Default: all history."},"end":{"type":"string","description":"End date (YYYY-MM-DD). Default: now."}},"required":["token"]},"response_example":{"token":"BTC","timeframe":"1h","bars":[{"timestamp":"2023-01-01T00:00:00Z","open":16541.0,"close":16538.0,"vbuy":1240000.0,"vsell":980000.0,"cvd":260000.0,"buy_ratio":0.56}]}},{"method":"POST","path":"/data/history/1d","price":"5.00","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","NEAR","ARB","SUI","OP","LTC","TRX","BCH","SHIB","HBAR","TON","XLM","UNI","AAVE"],"description":"Daily OHLCV + orderflow bars. Up to 7 years of history for 24 tokens.","agentPrompt":"Call for historical daily bars. Returns OHLCV plus orderflow fields. Compact dataset ideal for macro-level backtesting and trend analysis. Up to 7 years of history.","request_schema":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol (BTC, ETH, SOL, etc.)"},"start":{"type":"string","description":"Start date (YYYY-MM-DD). Default: all history."},"end":{"type":"string","description":"End date (YYYY-MM-DD). Default: now."}},"required":["token"]},"response_example":{"token":"BTC","timeframe":"1d","bars":[{"timestamp":"2023-01-01T00:00:00Z","open":16541.0,"close":16625.0,"vbuy":28400000.0,"vsell":22100000.0,"cvd":6300000.0,"buy_ratio":0.56}]}},{"method":"POST","path":"/data/history/5m","price":"1.00","currency":"USDC","tokens_supported":["BTC","ETH","SOL","XRP","ADA","DOGE","AVAX","LINK","BNB","ATOM","DOT","NEAR","ARB","SUI","OP","LTC","TRX","BCH","SHIB","HBAR","TON","XLM","UNI","AAVE"],"description":"5-minute OHLCV + orderflow bars. 17-day rolling window. 24 tokens.","agentPrompt":"Call for high-resolution 5-minute bars. Returns OHLCV plus orderflow fields. 17-day rolling window only — not suitable for long backtests. Use for short-term signal analysis.","request_schema":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol (BTC, ETH, SOL, etc.)"},"start":{"type":"string","description":"Start date (YYYY-MM-DD). Default: 17 days ago."},"end":{"type":"string","description":"End date (YYYY-MM-DD). Default: now."}},"required":["token"]},"response_example":{"token":"BTC","timeframe":"5m","bars":[{"timestamp":"2026-04-09T12:00:00Z","open":82500.0,"close":82550.0,"vbuy":4200000.0,"vsell":3800000.0,"cvd":400000.0,"buy_ratio":0.52}]}},{"method":"GET","path":"/health","price":"free","description":"Service status. Check first to verify the service is alive."},{"method":"GET","path":"/catalog","price":"free","description":"Machine-readable endpoint listing with pricing, schemas, and example responses."},{"method":"GET","path":"/demo","price":"free","description":"Cached BTC response from each paid endpoint. Validate output format before paying."},{"method":"GET","path":"/llms.txt","price":"free","description":"Agent-readable service description with use-case triggers."}],"data_sources":{"live_exchange_grid":"20 exchanges, 421 trading pairs, tick-level orderflow aggregated into 5-minute bars, 17-day rolling window, 24/7","token_composite_engine":"15 tokens (full coverage), ~70 fields per snapshot, 5-minute refresh from 10+ integrated sources with 7-day historical depth","market_intelligence_engine":"5-pillar composite: price momentum, on-chain health, sentiment, orderflow, smart money. Produces directional market reading with confidence score. Refreshed every 5 minutes.","macro_context":"DXY, VIX, 10Y yield, S&P500, gold, fed funds rate, yield curve slope, fear/greed from multiple institutional sources."}}