{"openapi":"3.1.0","info":{"title":"x402ti x402 V2 API","version":"v3","description":"Deterministic x402 V2 paid trading, macro & prediction-market intelligence API. Informational market/security data only; not financial advice.","x-guidance":"Pay per request via x402 V2 (exact EVM USDC in PAYMENT-SIGNATURE header) or via MCP (`npx -y x402ti-mcp`). Unpaid probes return HTTP 402 with PAYMENT-REQUIRED terms. Only HTTP 200 settles; 400/404/502/503 never settle. Recommended chains: call /v1/evm/safety ($0.01) + /v1/execution/quote-check?mode=evm ($0.01) before swapping unfamiliar EVM tokens; verify settlement rules when /v1/predictions/arb ($0.02) returns resolution_risk_warning=true. Scanners & Arb: /v1/perps/screener ($0.01), /v1/perps/funding-arb ($0.015, HL/dYdX/Kraken), /v1/predictions/scanner ($0.015, Polymarket+Kalshi), /v1/predictions/arb ($0.02, Polymarket vs Kalshi net arb), /v1/solana/trending ($0.015, RugCheck-scored). Deep Dives, Safety & Execution: /v1/evm/safety?address=<0x>&chain=base ($0.01, GoPlus+Honeypot.is), /v1/execution/quote-check?mode=perps&coin=BTC ($0.01, multi-tier EVM/Perps slippage), /v1/options/surface?currency=BTC ($0.015, Deribit IV/skew/max-pain), /v1/macro/liquidity ($0.01, US Treasury & NY Fed), /v1/perps/snapshot?coin=BTC ($0.005), /v1/solana/safety?mint=<MINT> ($0.01). Informational market/security data only; not financial advice.","contact":{"name":"x402ti Operator","url":"https://x402ti.malwowar.workers.dev"}},"servers":[{"url":"https://x402ti.malwowar.workers.dev"}],"security":[],"paths":{"/v1/solana/safety":{"get":{"operationId":"solana_safety","summary":"Solana SPL token safety & liquidity snapshot","description":"Deterministic Solana SPL token safety snapshot combining RugCheck security risks, authority flags, and DEX liquidity/volume/FDV ratios. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 Solana SPL token mint address (32-44 characters).","schema":{"type":"string","description":"Base58 Solana SPL token mint address (32-44 characters).","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112"},"example":"So11111111111111111111111111111111111111112"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["mint","risk_score","risk_tier","flags","security","market","metadata"],"properties":{"mint":{"type":"string"},"symbol":{"type":["string","null"]},"name":{"type":["string","null"]},"risk_score":{"type":"integer","minimum":0,"maximum":100},"risk_tier":{"type":"string","enum":["LOW","MODERATE","ELEVATED","CRITICAL"]},"flags":{"type":"array","items":{"type":"string"}},"security":{"type":"object","required":["rugcheck_score","rugcheck_score_normalized","lp_locked_pct","mint_authority_flagged","freeze_authority_flagged","mutable_metadata_flagged","risk_count","danger_count","warn_count","risks"],"properties":{"rugcheck_score":{"type":["number","null"]},"rugcheck_score_normalized":{"type":["number","null"]},"lp_locked_pct":{"type":["number","null"]},"mint_authority_flagged":{"type":"boolean"},"freeze_authority_flagged":{"type":"boolean"},"mutable_metadata_flagged":{"type":"boolean"},"risk_count":{"type":"integer"},"danger_count":{"type":"integer"},"warn_count":{"type":"integer"},"risks":{"type":"array","items":{"type":"object"}}}},"market":{"type":"object","required":["price_usd","liquidity_usd","volume_24h_usd","volume_to_liquidity_ratio","fdv_usd","fdv_to_liquidity_ratio","price_change_24h_pct","pair_count","primary_dex","primary_pair_address"],"properties":{"price_usd":{"type":["number","null"]},"liquidity_usd":{"type":"number"},"volume_24h_usd":{"type":"number"},"volume_to_liquidity_ratio":{"type":["number","null"]},"fdv_usd":{"type":["number","null"]},"fdv_to_liquidity_ratio":{"type":["number","null"]},"price_change_24h_pct":{"type":["number","null"]},"pair_count":{"type":"integer"},"primary_dex":{"type":["string","null"]},"primary_pair_address":{"type":["string","null"]}}},"metadata":{"type":"object","required":["fetched_at","sources","disclaimer"],"properties":{"fetched_at":{"type":"string","format":"date-time"},"sources":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}}}}},"example":{"mint":"So11111111111111111111111111111111111111112","symbol":"SOL","name":"Wrapped SOL","risk_score":5,"risk_tier":"LOW","flags":["LP_LOCK_UNKNOWN"],"security":{"rugcheck_score":1,"rugcheck_score_normalized":1,"lp_locked_pct":null,"mint_authority_flagged":false,"freeze_authority_flagged":false,"mutable_metadata_flagged":false,"risk_count":0,"danger_count":0,"warn_count":0,"risks":[]},"market":{"price_usd":180.25,"liquidity_usd":45000000,"volume_24h_usd":125000000,"volume_to_liquidity_ratio":2.7778,"fdv_usd":98000000000,"fdv_to_liquidity_ratio":2177.78,"price_change_24h_pct":2.4,"pair_count":14,"primary_dex":"raydium","primary_pair_address":"58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"},"metadata":{"fetched_at":"2026-11-21T17:00:00.000Z","sources":["rugcheck","dexscreener"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/solana/trending":{"get":{"operationId":"solana_trending","summary":"Trending Solana tokens pre-screened with RugCheck safety scores","description":"Live trending Solana pools combined with parallel RugCheck deterministic risk scores, authority flags, liquidity, and 24h trader flow in one call. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015"}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Optional number of trending tokens to return (integer 1-8, default 5).","schema":{"type":"string","description":"Optional number of trending tokens to return (integer 1-8, default 5).","example":"5"},"example":"5"},{"name":"max_risk_score","in":"query","required":false,"description":"Optional ceiling (0-100) to return only RugCheck-verified tokens at or below this risk score.","schema":{"type":"string","description":"Optional ceiling (0-100) to return only RugCheck-verified tokens at or below this risk score.","example":"50"},"example":"50"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["filters","scanned_count","returned_count","tokens","metadata"],"properties":{"filters":{"type":"object"},"scanned_count":{"type":"integer"},"returned_count":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"filters":{"limit":5,"max_risk_score":null},"scanned_count":5,"returned_count":1,"tokens":[{"rank":1,"mint":"2j5SaS7xy776qCBpyPQbZjyQSAtKiFgrwjfErthnW2ZM","symbol":"CLAUDIA","pool_name":"CLAUDIA / SOL","dex":"pumpswap","pool_address":"Fe7bpDYCs74GqiCUF14HwgUMToPKV1d9mDYVX5BTohFr","pool_created_at":"2026-10-07T01:44:30Z","safety":{"verified":true,"risk_score":18,"risk_tier":"LOW","flags":[],"lp_locked_pct":95,"mint_authority_flagged":false,"freeze_authority_flagged":false,"mutable_metadata_flagged":false,"danger_count":0,"warn_count":0},"market":{"price_usd":0.0095,"liquidity_usd":440581.1,"volume_24h_usd":2951408.67,"volume_to_liquidity_ratio":6.6989,"fdv_usd":8989783.46,"price_change_24h_pct":61.21,"buys_24h":13786,"sells_24h":12501,"buy_sell_ratio_24h":1.1028,"unique_traders_24h":5012}}],"metadata":{"fetched_at":"2026-11-21T17:00:00.000Z","sources":["geckoterminal","rugcheck"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/perps/snapshot":{"get":{"operationId":"perps_snapshot","summary":"Hyperliquid perpetual futures market snapshot","description":"Deterministic Hyperliquid perpetual futures snapshot with mark/oracle basis, annualized funding rate, open interest, spread, L2 depth imbalance, and $10k VWAP slippage. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid perpetual ticker symbol (e.g., BTC, ETH, SOL, kPEPE; optional -PERP suffix stripped).","schema":{"type":"string","description":"Hyperliquid perpetual ticker symbol (e.g., BTC, ETH, SOL, kPEPE; optional -PERP suffix stripped).","pattern":"^[A-Za-z0-9]{1,16}(?:-[Pp][Ee][Rr][Pp])?$","example":"BTC"},"example":"BTC"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["coin","market","funding","orderbook","metadata"],"properties":{"coin":{"type":"string"},"market":{"type":"object"},"funding":{"type":"object"},"orderbook":{"type":"object"},"metadata":{"type":"object"}}},"example":{"coin":"BTC","market":{"mark_price":95000.5,"oracle_price":94990,"mid_price":95000.25,"mark_oracle_basis_bps":1.1054,"prev_day_price":93200,"price_change_24h_pct":1.9319,"volume_24h_usd":4520000000,"open_interest_base":25000,"open_interest_usd":2375012500,"volume_to_oi_ratio":1.9031,"max_leverage":50},"funding":{"hourly_rate":0.0000125,"annualized_pct":10.95,"premium":0.00011,"regime":"POSITIVE"},"orderbook":{"best_bid":95000,"best_ask":95000.5,"spread_bps":0.0526,"bid_depth_5_usd":1250000,"ask_depth_5_usd":1100000,"imbalance_5":0.0638,"slippage_10k_buy_bps":0.0263,"slippage_10k_sell_bps":0.0263,"levels_sampled":5},"metadata":{"fetched_at":"2026-11-21T17:00:00.000Z","sources":["hyperliquid"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/perps/screener":{"get":{"operationId":"perps_screener","summary":"Hyperliquid all-markets perpetual futures screener","description":"Scans all ~180+ Hyperliquid perpetuals in one call: market breadth, median funding APR, and top leaderboards for extreme funding, mark/oracle basis dislocations, and volume/OI turnover. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"min_oi_usd","in":"query","required":false,"description":"Optional minimum open interest USD filter (default 1000000).","schema":{"type":"string","description":"Optional minimum open interest USD filter (default 1000000).","example":"1000000"},"example":"1000000"},{"name":"limit","in":"query","required":false,"description":"Optional leaderboard size per category (1-25, default 10).","schema":{"type":"string","description":"Optional leaderboard size per category (1-25, default 10).","example":"10"},"example":"10"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["venue","filters","market_summary","highest_funding","lowest_funding","widest_basis","highest_turnover","metadata"],"properties":{"venue":{"type":"string"},"filters":{"type":"object"},"market_summary":{"type":"object"},"highest_funding":{"type":"array","items":{"type":"object"}},"lowest_funding":{"type":"array","items":{"type":"object"}},"widest_basis":{"type":"array","items":{"type":"object"}},"highest_turnover":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"venue":"hyperliquid","filters":{"min_oi_usd":1000000,"limit":10},"market_summary":{"total_markets":185,"qualifying_markets":74,"total_open_interest_usd":6850000000,"total_volume_24h_usd":14200000000,"median_funding_annualized_pct":9.85,"positive_funding_count":142,"negative_funding_count":25,"neutral_funding_count":18},"highest_funding":[],"lowest_funding":[],"widest_basis":[],"highest_turnover":[],"metadata":{"fetched_at":"2026-11-21T17:00:00.000Z","sources":["hyperliquid"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/perps/funding-arb":{"get":{"operationId":"perps_funding_arb","summary":"Cross-venue perpetual funding spread scanner (Hyperliquid, dYdX v4, Kraken Futures)","description":"Compares live hourly & annualized funding rates across Hyperliquid, dYdX v4, and Kraken Futures in one call to surface the widest cross-venue funding spreads and mark-price basis. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015"}},"parameters":[{"name":"min_oi_usd","in":"query","required":false,"description":"Optional minimum per-venue open interest USD filter applied to each participating leg (default 100000; ignored when coin is set).","schema":{"type":"string","description":"Optional minimum per-venue open interest USD filter applied to each participating leg (default 100000; ignored when coin is set).","example":"100000"},"example":"100000"},{"name":"limit","in":"query","required":false,"description":"Optional number of top cross-venue spreads to return (1-25, default 10).","schema":{"type":"string","description":"Optional number of top cross-venue spreads to return (1-25, default 10).","example":"10"},"example":"10"},{"name":"coin","in":"query","required":false,"description":"Optional base asset symbol filter (e.g., BTC, ETH, SOL).","schema":{"type":"string","description":"Optional base asset symbol filter (e.g., BTC, ETH, SOL).","example":"BTC"},"example":"BTC"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["filters","venues_active","matched_assets_count","opportunities","metadata"],"properties":{"filters":{"type":"object"},"venues_active":{"type":"array","items":{"type":"string"}},"matched_assets_count":{"type":"integer"},"opportunities":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"filters":{"min_oi_usd":100000,"limit":10,"coin":null},"venues_active":["hyperliquid","dydx","kraken"],"matched_assets_count":34,"opportunities":[{"asset":"SOL","venues_compared":3,"spread_annualized_pct":23.74,"highest_funding_venue":"dydx","lowest_funding_venue":"kraken","mark_price_spread_bps":0.49,"min_open_interest_usd":8858759,"max_open_interest_usd":185000000,"venues":{"hyperliquid":{"symbol":"SOL","hourly_rate":0.000012,"annualized_pct":10.512,"mark_price":70.23,"open_interest_usd":185000000,"volume_24h_usd":420000000},"dydx":{"symbol":"SOL-USD","hourly_rate":0.00003214,"annualized_pct":28.1546,"mark_price":70.2257,"open_interest_usd":8858759,"volume_24h_usd":354042},"kraken":{"symbol":"PF_SOLUSD","hourly_rate":0.00000504,"annualized_pct":4.415,"mark_price":70.2223,"open_interest_usd":14620286,"volume_24h_usd":49212396}}}],"metadata":{"fetched_at":"2026-11-21T17:00:00.000Z","sources":["hyperliquid","dydx","kraken"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/predictions/scanner":{"get":{"operationId":"predictions_scanner","summary":"Polymarket + Kalshi live prediction markets scanner & carry finder","description":"Scans live Polymarket and Kalshi prediction markets in one call with implied probabilities, bid-ask spreads, 24h volume/liquidity ratios, keyword search, and high-conviction annualized carry to expiry. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015"}},"parameters":[{"name":"venue","in":"query","required":false,"description":"Optional venue filter: all (default), polymarket, or kalshi.","schema":{"type":"string","description":"Optional venue filter: all (default), polymarket, or kalshi.","enum":["all","polymarket","kalshi"],"example":"all"},"example":"all"},{"name":"query","in":"query","required":false,"description":"Optional keyword search across market titles, tickers, and categories (1-64 chars).","schema":{"type":"string","description":"Optional keyword search across market titles, tickers, and categories (1-64 chars).","example":"bitcoin"},"example":"bitcoin"},{"name":"min_volume_24h_usd","in":"query","required":false,"description":"Optional minimum 24h USD volume filter (default 1000; default 0 when query is set).","schema":{"type":"string","description":"Optional minimum 24h USD volume filter (default 1000; default 0 when query is set).","example":"1000"},"example":"1000"},{"name":"limit","in":"query","required":false,"description":"Optional leaderboard size per category (1-25, default 10).","schema":{"type":"string","description":"Optional leaderboard size per category (1-25, default 10).","example":"10"},"example":"10"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["filters","venues_active","market_summary","top_by_volume","high_conviction_carry","widest_spreads","metadata"],"properties":{"filters":{"type":"object"},"venues_active":{"type":"array","items":{"type":"string"}},"market_summary":{"type":"object"},"top_by_volume":{"type":"array","items":{"type":"object"}},"high_conviction_carry":{"type":"array","items":{"type":"object"}},"widest_spreads":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"filters":{"venue":"all","query":null,"min_volume_24h_usd":1000,"limit":10},"venues_active":["polymarket","kalshi"],"market_summary":{"scanned_count":250,"matching_count":148,"polymarket_count":92,"kalshi_count":56,"total_volume_24h_usd":48250000},"top_by_volume":[{"venue":"polymarket","id":"517310","title":"Will BTC trade above $100k before December 31?","category":"Crypto","yes_prob":0.88,"no_prob":0.12,"bid_ask_spread_bps":100,"volume_24h_usd":4250000,"liquidity_usd":1850000,"volume_to_liquidity_ratio":2.2973,"expires_at":"2026-12-31T23:59:00Z","hours_to_expiry":946,"dominant_side":"YES","dominant_prob":0.88,"implied_annualized_carry_pct":126.25,"url":"https://polymarket.com/market/btc-above-100k-dec-31"}],"high_conviction_carry":[],"widest_spreads":[],"metadata":{"fetched_at":"2026-11-22T12:00:00.000Z","sources":["polymarket","kalshi"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/options/surface":{"get":{"operationId":"options_surface","summary":"Deribit BTC/ETH options volatility surface, skew, max pain & OI walls","description":"Distills hundreds of live Deribit BTC or ETH option contracts into one deterministic brief: ATM IV term structure, contango/backwardation slope, OTM put-call skew, put/call OI ratios, exact max pain strike, and top call/put OI walls. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015"}},"parameters":[{"name":"currency","in":"query","required":false,"description":"Underlying asset symbol: BTC (default) or ETH.","schema":{"type":"string","description":"Underlying asset symbol: BTC (default) or ETH.","enum":["BTC","ETH"],"example":"BTC"},"example":"BTC"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["venue","currency","spot_index_price","summary","vol_regime","nearest_major_expiry","term_structure","metadata"],"properties":{"venue":{"type":"string"},"currency":{"type":"string"},"spot_index_price":{"type":"number"},"summary":{"type":"object"},"vol_regime":{"type":"object"},"nearest_major_expiry":{"type":["object","null"]},"term_structure":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"venue":"deribit","currency":"BTC","spot_index_price":95000,"summary":{"total_contracts":612,"total_open_interest_contracts":185400,"total_open_interest_usd":17613000000,"call_open_interest_contracts":121200,"put_open_interest_contracts":64200,"put_call_oi_ratio":0.5297,"volume_24h_contracts":24500,"volume_24h_usd":2327500000,"put_call_volume_ratio":0.612},"vol_regime":{"front_atm_iv_pct":52.4,"mid_30d_atm_iv_pct":57.1,"term_slope_iv_pts":4.7,"structure":"CONTANGO","front_skew_iv_pts":3.2,"skew_regime":"PUT_PREMIUM"},"nearest_major_expiry":{"expiry_code":"27NOV26","expiry_iso":"2026-11-27T08:00:00.000Z","dte_days":4.83,"max_pain_strike":94000,"max_pain_distance_pct":-1.05,"top_call_walls":[{"strike":100000,"open_interest":12500,"open_interest_usd":1187500000,"distance_from_spot_pct":5.26}],"top_put_walls":[{"strike":90000,"open_interest":8900,"open_interest_usd":845500000,"distance_from_spot_pct":-5.26}]},"term_structure":[],"metadata":{"fetched_at":"2026-11-22T12:00:00.000Z","sources":["deribit"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/macro/liquidity":{"get":{"operationId":"macro_liquidity","summary":"Official US Treasury debt, TGA cash, NY Fed ON RRP, SOFR/EFFR & net liquidity impulse","description":"Combines 5 official US Treasury Fiscal Data and NY Fed feeds in one call: exact US public debt, Treasury General Account (TGA) balance & flows, ON RRP balance, EFFR/SOFR funding spread (bps), and deterministic net USD liquidity impulse. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"lookback_obs","in":"query","required":false,"description":"Optional number of recent business-day observations for liquidity delta (integer 2-20, default 5).","schema":{"type":"string","description":"Optional number of recent business-day observations for liquidity delta (integer 2-20, default 5).","example":"5"},"example":"5"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["lookback_obs","us_debt","tga","on_rrp","rates","liquidity_impulse","metadata"],"properties":{"lookback_obs":{"type":"integer"},"us_debt":{"type":["object","null"]},"tga":{"type":["object","null"]},"on_rrp":{"type":["object","null"]},"rates":{"type":"object"},"liquidity_impulse":{"type":"object"},"metadata":{"type":"object"}}},"example":{"lookback_obs":5,"us_debt":{"record_date":"2026-11-20","total_public_debt_usd":36542100000000,"debt_held_public_usd":29120000000000,"intragov_holdings_usd":7422100000000,"daily_change_usd":14500000000,"period_change_usd":68200000000},"tga":{"record_date":"2026-11-20","closing_balance_usd":785400000000,"daily_change_usd":-12300000000,"period_change_usd":-34500000000},"on_rrp":{"operation_date":"2026-11-20","accepted_usd":142000000000,"award_rate_pct":4.25,"counterparties_accepted":48,"daily_change_usd":-8500000000,"period_change_usd":-21000000000},"rates":{"effr_date":"2026-11-20","effr_pct":4.33,"fomc_target_low_pct":4.25,"fomc_target_high_pct":4.5,"sofr_date":"2026-11-20","sofr_pct":4.35,"sofr_volume_billions":2180.5,"sofr_effr_spread_bps":2,"funding_stress_regime":"NORMAL"},"liquidity_impulse":{"lookback_obs":5,"tga_liquidity_effect_usd":34500000000,"rrp_liquidity_effect_usd":21000000000,"combined_net_impulse_usd":55500000000,"regime":"EXPANDING"},"metadata":{"fetched_at":"2026-11-22T12:00:00.000Z","sources":["treasury_debt","treasury_tga","nyfed_rrp","nyfed_sofr","nyfed_effr"],"missing_sources":[],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/evm/safety":{"get":{"operationId":"evm_safety","summary":"Multi-chain EVM token safety, honeypot simulation & DEX liquidity audit","description":"Deterministic EVM token safety audit across Base, Ethereum, Arbitrum, Optimism, Polygon, and BSC combining GoPlus security, Honeypot.is simulation, engine disagreement flags, and DEX liquidity ratios. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"address","in":"query","required":true,"description":"EVM ERC-20 token contract address (0x followed by 40 hex characters).","schema":{"type":"string","description":"EVM ERC-20 token contract address (0x followed by 40 hex characters).","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"name":"chain","in":"query","required":false,"description":"Optional EVM chain: base (default), ethereum, arbitrum, optimism, polygon, or bsc.","schema":{"type":"string","description":"Optional EVM chain: base (default), ethereum, arbitrum, optimism, polygon, or bsc.","enum":["base","ethereum","arbitrum","optimism","polygon","bsc"],"example":"base"},"example":"base"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["address","chain","chain_id","risk_score","risk_tier","flags","security","market","metadata"],"properties":{"address":{"type":"string"},"chain":{"type":"string"},"chain_id":{"type":"integer"},"symbol":{"type":["string","null"]},"name":{"type":["string","null"]},"risk_score":{"type":"integer","minimum":0,"maximum":100},"risk_tier":{"type":"string","enum":["LOW","MODERATE","ELEVATED","CRITICAL"]},"flags":{"type":"array","items":{"type":"string"}},"security":{"type":"object"},"market":{"type":"object"},"metadata":{"type":"object"}}},"example":{"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","chain":"base","chain_id":8453,"symbol":"USDC","name":"USD Coin","risk_score":5,"risk_tier":"LOW","flags":["PROXY_CONTRACT"],"security":{"is_honeypot":false,"engine_disagreement":false,"simulation_success":true,"buy_tax_pct":0,"sell_tax_pct":0,"transfer_tax_pct":0,"is_open_source":true,"is_proxy":true,"is_mintable":false,"owner_change_balance":false,"hidden_owner":false,"can_take_back_ownership":false,"selfdestruct":false,"cannot_buy":false,"cannot_sell_all":false,"transfer_pausable":false,"is_blacklisted":false,"slippage_modifiable":false,"owner_renounced":false,"holder_count":1500000,"top10_holder_pct":22.5,"lp_locked_pct":null,"engines":{"goplus":"ok","honeypot_is":"ok"}},"market":{"price_usd":1,"liquidity_usd":420000000,"volume_24h_usd":850000000,"volume_to_liquidity_ratio":2.0238,"fdv_usd":3500000000,"fdv_to_liquidity_ratio":8.3333,"price_change_24h_pct":0.01,"pair_count":25,"pair_age_hours":18000,"primary_dex":"aerodrome","primary_pair_address":"0x0000000000000000000000000000000000000001"},"metadata":{"fetched_at":"2026-11-22T12:00:00.000Z","sources":["goplus","honeypot_is","dexscreener"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/predictions/arb":{"get":{"operationId":"predictions_arb","summary":"Polymarket vs Kalshi cross-venue prediction market arbitrage detector","description":"Matches overlapping Polymarket and Kalshi prediction markets within a 72h expiry window to surface cross-venue arbitrage spreads, fee-adjusted net edge (bps), annualized APY, and resolution-risk warnings. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"min_spread_bps","in":"query","required":false,"description":"Optional minimum fee-adjusted net edge in basis points (0-5000, default 150).","schema":{"type":"string","description":"Optional minimum fee-adjusted net edge in basis points (0-5000, default 150).","example":"150"},"example":"150"},{"name":"min_liquidity_usd","in":"query","required":false,"description":"Optional minimum per-venue liquidity USD filter (default 5000).","schema":{"type":"string","description":"Optional minimum per-venue liquidity USD filter (default 5000).","example":"5000"},"example":"5000"},{"name":"query","in":"query","required":false,"description":"Optional keyword search across matched market titles/categories (1-64 chars).","schema":{"type":"string","description":"Optional keyword search across matched market titles/categories (1-64 chars).","example":"bitcoin"},"example":"bitcoin"},{"name":"limit","in":"query","required":false,"description":"Optional maximum opportunities to return (1-30, default 15).","schema":{"type":"string","description":"Optional maximum opportunities to return (1-30, default 15).","example":"15"},"example":"15"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["filters","venues_active","summary","opportunities","metadata"],"properties":{"filters":{"type":"object"},"venues_active":{"type":"array","items":{"type":"string"}},"summary":{"type":"object"},"opportunities":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"filters":{"min_spread_bps":150,"min_liquidity_usd":5000,"query":null,"limit":15},"venues_active":["polymarket","kalshi"],"summary":{"polymarket_scanned":150,"kalshi_scanned":100,"polymarket_eligible":80,"kalshi_eligible":80,"matched_pairs_count":6,"qualifying_opportunities_count":2,"best_net_edge_bps":420.5},"opportunities":[],"metadata":{"fetched_at":"2026-11-22T12:00:00.000Z","sources":["polymarket","kalshi"],"fee_model":"Kalshi parabolic taker fee 0.07*p*(1-p) + 20bps Polymarket execution buffer (+50bps/leg if mid fallback)","disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}},"/v1/execution/quote-check":{"get":{"operationId":"execution_quote_check","summary":"Multi-tier pre-trade slippage & liquidity check for EVM swaps and Hyperliquid perps","description":"Pre-trade execution and slippage simulator across USD size tiers ($1k/$10k/$50k+) for EVM DEX swaps (KyberSwap Aggregator + DEX Screener) or Hyperliquid perpetual L2 books, returning price impact bps, max size under 100bps, and liquidity grade. Informational market/security data only; not financial advice.","security":[],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"mode","in":"query","required":true,"description":"Required mode: 'perps' (Hyperliquid L2 orderbook) or 'evm' (KyberSwap DEX aggregator).","schema":{"type":"string","description":"Required mode: 'perps' (Hyperliquid L2 orderbook) or 'evm' (KyberSwap DEX aggregator).","enum":["perps","evm"],"example":"perps"},"example":"perps"},{"name":"coin","in":"query","required":false,"description":"Required when mode=perps: Hyperliquid ticker symbol (e.g., BTC, ETH, SOL).","schema":{"type":"string","description":"Required when mode=perps: Hyperliquid ticker symbol (e.g., BTC, ETH, SOL).","example":"BTC"},"example":"BTC"},{"name":"side","in":"query","required":false,"description":"Optional when mode=perps: 'buy', 'sell', or 'both' (default 'both').","schema":{"type":"string","description":"Optional when mode=perps: 'buy', 'sell', or 'both' (default 'both').","enum":["buy","sell","both"],"example":"both"},"example":"both"},{"name":"chain","in":"query","required":false,"description":"Optional when mode=evm: base (default), ethereum, arbitrum, optimism, polygon, or bsc.","schema":{"type":"string","description":"Optional when mode=evm: base (default), ethereum, arbitrum, optimism, polygon, or bsc.","enum":["base","ethereum","arbitrum","optimism","polygon","bsc"],"example":"base"},"example":"base"},{"name":"token_out","in":"query","required":false,"description":"Required when mode=evm: destination ERC-20 token address (0x...).","schema":{"type":"string","description":"Required when mode=evm: destination ERC-20 token address (0x...).","example":"0x4200000000000000000000000000000000000006"},"example":"0x4200000000000000000000000000000000000006"},{"name":"token_in","in":"query","required":false,"description":"Optional when mode=evm: source ERC-20 token address (defaults to native USDC on chain).","schema":{"type":"string","description":"Optional when mode=evm: source ERC-20 token address (defaults to native USDC on chain).","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"name":"token_in_decimals","in":"query","required":false,"description":"Optional when mode=evm: decimals (0-18) required only for custom non-registry token_in.","schema":{"type":"string","description":"Optional when mode=evm: decimals (0-18) required only for custom non-registry token_in.","example":"6"},"example":"6"},{"name":"sizes_usd","in":"query","required":false,"description":"Optional comma-separated USD tiers (up to 3 for evm, 4 for perps; e.g. '1000,10000,50000').","schema":{"type":"string","description":"Optional comma-separated USD tiers (up to 3 for evm, 4 for perps; e.g. '1000,10000,50000').","example":"1000,10000,50000"},"example":"1000,10000,50000"}],"responses":{"200":{"description":"Successful paid response (payment settled).","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 V2 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["mode","executable_any","max_size_under_100bps_usd","liquidity_grade","flags","tiers","metadata"],"properties":{"mode":{"type":"string","enum":["perps","evm"]},"executable_any":{"type":"boolean"},"max_size_under_100bps_usd":{"type":"number"},"liquidity_grade":{"type":"string","enum":["DEEP","ADEQUATE","THIN","ILLIQUID"]},"flags":{"type":"array","items":{"type":"string"}},"tiers":{"type":"array","items":{"type":"object"}},"metadata":{"type":"object"}}},"example":{"mode":"perps","venue":"hyperliquid","coin":"BTC","side":"both","mid_price":95000.25,"best_bid":95000,"best_ask":95000.5,"spread_bps":0.0526,"executable_any":true,"max_size_under_100bps_usd":1500000,"liquidity_grade":"DEEP","flags":[],"tiers":[{"size_usd":10000,"buy":{"executable":true,"fill_pct":100,"effective_price":95000.5,"vwap_slippage_bps":0.0263,"price_impact_bps":0.0263,"levels_consumed":1},"sell":{"executable":true,"fill_pct":100,"effective_price":95000,"vwap_slippage_bps":0.0263,"price_impact_bps":0.0263,"levels_consumed":1}}],"metadata":{"fetched_at":"2026-11-22T12:00:00.000Z","sources":["hyperliquid"],"disclaimer":"Informational market/security data only; not financial advice."}}}}},"400":{"description":"Invalid query parameter (payment NOT settled).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 V2 payment terms returned in PAYMENT-REQUIRED header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 PaymentRequired payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Requested token or perpetual market not found (payment NOT settled)."},"502":{"description":"Upstream data provider unavailable (payment NOT settled)."},"503":{"description":"Service temporarily paused by operator (payment NOT charged)."}}}}}}