{"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":15,"description":"Raw Pillar token snapshot. 16 reliably populated fields — price, volume, on-chain metrics (MVRV, active addresses, exchange flows, funding rate, open interest), orderflow (CVD, buy_ratio, whale bars, liquidations, spot/perp delta, HHI), and sentiment. No LLM, no processing. Use as feed input for your own models.","use_when":"When you want raw data to process yourself, or to build derived signals on top of Pillar's data.","answers":"What is the current raw market state for this token?","request_body":{"token":"BTC"},"response_example":{"token":"BTC","timestamp":"2026-04-08T12:00:00Z","snapshot":{"price_usd":84250.0,"change_pct_24h":2.3,"buy_ratio":0.61,"cvd_1h":14523.7,"whale_bar_count_1h":3,"funding_rate":0.0045,"mvrv":1.23,"active_addresses":820000,"exchange_flow_net":-12400000.0,"volume_herfindahl":0.22,"note":"16 reliable fields — all shown above"},"data_freshness":{"data_age_seconds":98,"stale":false}}},{"method":"POST","path":"/analyze/market","price":"0.25","tokens_supported":15,"description":"Call before any crypto position decision. Returns price snapshot, proprietary signal direction with confidence, and macro regime (DXY, VIX, Fear & Greed). Data-only, no LLM latency.","use_when":"Pre-trade macro check, portfolio rebalancing, risk assessment before entering a position.","answers":"Is the macro environment aligned for this trade?","request_body":{"token":"BTC","depth":"full"},"response_example":{"token":"BTC","timestamp":"2026-04-05T12: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"},"data_freshness":{"stale":false}}},{"method":"POST","path":"/analyze/orderflow","price":"0.50","tokens_supported":24,"description":"Call when you need to know if a price move is real. Returns cross-exchange CVD, whale activity, liquidation pressure, spot/perp delta, and volume concentration from 20 live venues. Data-only.","use_when":"Before executing any trade over $100, validating a price alert, checking if a breakout is real.","answers":"Is this pump backed by real volume or is it manipulation?","request_body":{"token":"ETH","depth":"full"},"response_example":{"token":"ETH","timestamp":"2026-04-05T12: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"},"data_freshness":{"stale":false}}},{"method":"POST","path":"/analyze/full","price":"0.75","tokens_supported":15,"description":"Complete pre-trade due diligence in one call. All data from /market and /orderflow, plus a single grounded LLM call. Returns stance (BULLISH/BEARISH/NEUTRAL), orderflow_signal (ACCUMULATION/DISTRIBUTION/NEUTRAL), risk_level (LOW/MODERATE/HIGH/CRITICAL), and a one-sentence verdict citing specific data values.","use_when":"Before any significant trade. Saves 2 separate calls. Full picture in one payment.","answers":"Should I trade this token right now?","request_body":{"token":"BTC","depth":"full"},"response_example":{"token":"BTC","timestamp":"2026-04-05T12:00:00Z","pulse_signal":"up","signal_confidence":0.72,"macro_regime":"risk_on","cvd_direction":"up","buy_ratio":0.61,"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. Orderflow: ACCUMULATION across 14/20 exchanges. Risk: LOW. All signals aligned — favorable entry.","data_freshness":{"stale":false}}},{"method":"POST","path":"/analyze/address","price":"0.25","currency":"USDC","description":"On-chain address profile + mechanical risk scoring. Auto-detects EVM (Ethereum) or Solana from address format.","chains_supported":["evm","solana"],"use_when":"When you need to know who or what an address is, and whether it's risky.","answers":"Is this address a contract or wallet? Is it risky? What tokens does it hold?","request_body":{"address":"0x... or base58..."},"response_example":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"evm","address_type":"wallet","risk_level":"low","flags":[],"native_balance":240.5,"tx_count":1243,"entity_label":"Vitalik Buterin","top_tokens":[{"symbol":"USDC","balance":50000.0,"value_usd":50000.0}],"data_freshness":{"stale":false}}},{"method":"POST","path":"/data/history/1h","price":"5.00","tokens_supported":24,"description":"Hourly OHLC + orderflow bars. Up to 5,000 bars per call. Up to 7 years of history for major tokens. Supports date range queries.","use_when":"Backtesting, model training, historical orderflow analysis, signal validation.","request_body":{"token":"BTC","limit":500},"request_body_with_range":{"token":"BTC","start":"2021-01-01","end":"2021-12-31","limit":5000},"response_fields":["timestamp","open","high","low","close","vbuy","vsell","cvd","buy_ratio","lbuy","lsell"],"response_headers":{"X-Venues-Aggregated":"1","X-Data-Delay":"0"},"notes":"Without start/end: newest-first. With start/end: oldest-first, paginate by shifting start date."},{"method":"POST","path":"/data/history/1d","price":"5.00","tokens_supported":24,"description":"Daily OHLC + orderflow bars. Up to 7 years of history for major tokens. Supports date range queries.","request_body":{"token":"ETH","start":"2020-01-01","end":"2024-12-31"},"response_fields":["timestamp","open","high","low","close","vbuy","vsell","cvd","buy_ratio","lbuy","lsell"]},{"method":"POST","path":"/data/history/5m","price":"1.00","tokens_supported":24,"description":"5-minute bars. 17-day rolling window (live collection, no historical backfill). X-Data-Delay: 300 header confirms 5-minute delay.","request_body":{"token":"SOL","limit":288},"response_headers":{"X-Venues-Aggregated":"1","X-Data-Delay":"300"}},{"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":"Cached BTC response from each paid endpoint. Validate output format before paying."},{"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"}