{"openapi":"3.1.0","info":{"title":"x402-seller","version":"0.4.0","description":"Rug protection and decision-ready intelligence for autonomous trading agents. Keyless by design: no signup, no API key — pay a cent per request in USDC (x402). The /alpha/launches LAUNCH RADAR discovers what just launched AND rug-screens every candidate in one call, ranked per-token verdicts — the proactive 'give me safe alpha' call. /vet gives a single-token go/no-go in ONE call by fusing a COMPOSITE rug score (GoPlus static analysis + a LIVE Honeypot.is buy/sell simulation + serial-rugger check) with our SELF-COLLECTED liquidity-drain trend — a rug-in-progress signal that exists nowhere for free because it requires collecting reserves over time. One call is cheaper than the inference tokens you'd burn stitching 4 free APIs, and it stops your agent losing its whole position to a honeypot. Also: /onchain/liquidity drain detector, /screen batch watchlist check, /brief market regime, and raw feeds (prices, stocks, DEX pools, launches, perp funding/OI).","contact":{"name":"x402-seller","email":"wyattpalm2+x402@gmail.com","url":"https://github.com/wyattpalm2-eng/x402-seller"},"x-guidance":"Keyless x402 API. GET any path with no payment for the 402 challenge, pay the quoted USDC amount on Base mainnet, retry with X-PAYMENT. Prefer /vet and /brief for decision-ready single-call answers over composing the raw feeds yourself. See /llms.txt for a plain-text guide."},"servers":[{"url":"https://x402-seller-m8nx.onrender.com"}],"paths":{"/weather/consensus":{"get":{"operationId":"weather_consensus","summary":"Cross-source weather consensus: blends Open-Meteo + NOAA/NWS + 7Timer into one temperature plus an agreement score (how much the models agree)","description":"Cross-source weather consensus: blends Open-Meteo + NOAA/NWS + 7Timer into one temperature plus an agreement score (how much the models agree). Keyless — one call instead of stitching 3 free weather APIs and reconciling them yourself. First endpoint built by the autonomous crew and ported through the bridge.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":"40.71"},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":"-74.01"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"lat":40.71,"lon":-74.01},"consensus":{"blendedTempC":26,"agreementScore":53,"sourceCount":2,"stdevC":2.35},"sources":[{"source":"open-meteo","tempC":23.6},{"source":"noaa-nws","tempC":28.3},{"source":"7timer","error":"timeout"}]}}}},"402":{"description":"Payment required (x402)"}}}},"/alpha/launches":{"get":{"operationId":"alpha_launches","summary":"LAUNCH RADAR — one call discovers what just launched AND rug-screens every candidate through the composite score (static + live buy/sell simulation, or the Solana dual-engine) + liquidity, returning a ranked shortlist with a per-token verdict","description":"LAUNCH RADAR — one call discovers what just launched AND rug-screens every candidate through the composite score (static + live buy/sell simulation, or the Solana dual-engine) + liquidity, returning a ranked shortlist with a per-token verdict. Replaces 10+ free-API calls and the coordination logic an agent would build: aggregating launch feeds, running per-candidate honeypot simulations, computing the composite risk score, reconciling free sources, and ranking by safety. The proactive 'give me safe alpha' endpoint for launch-sniping agents.","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","solana","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"base","headline":"2 of 10 fresh launches look clear — safest: BONKFI","summary":{"scanned":10,"clear":2,"caution":3,"avoid":4,"unrated":1},"launches":[{"token":"BONKFI","address":"0x…","verdict":"ok","risk_score":10,"honeypot":false,"top_flag":null,"liquidity_usd":82000,"liquidity_trend":"growing","launched":"2026-07-19T12:40:00Z"},{"token":"SCAMZ","address":"0x…","verdict":"danger","risk_score":100,"honeypot":true,"top_flag":"HONEYPOT: live sell simulation FAILED","liquidity_usd":5400}]}}}},"402":{"description":"Payment required (x402)"}}}},"/wx/storm":{"get":{"operationId":"wx_storm","summary":"STORM RISK for any coordinate on Earth — resolves NOAA/NWS active-alert GeoJSON polygons with real point-in-polygon geometry, blends in wind speed and alert severity, and returns ONE scored risk verdict","description":"STORM RISK for any coordinate on Earth — resolves NOAA/NWS active-alert GeoJSON polygons with real point-in-polygon geometry, blends in wind speed and alert severity, and returns ONE scored risk verdict. Replaces the whole pipeline an agent would otherwise build: fetch the alert feed, parse multi-ring GeoJSON, run point-in-polygon per alert, reconcile severity vocabularies, and merge a second wind source. Independently scored 9/10 by a bot-buyer panel: 'paying $0.04 to instantly bypass complex GeoJSON parsing, point-in-polygon math, and multiple API orchestration is a highly efficient time-saver.' Keyless, no signup, works worldwide (richest inside US NWS coverage). For logistics routing, drone/flight go-no-go, field-ops scheduling and insurance triggers.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":"30.26"},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":"-97.74"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"lat":30.26,"lon":-97.74},"risk":{"score":62,"level":"elevated","headline":"1 active severe alert covers this point"},"alerts":[{"event":"Severe Thunderstorm Warning","severity":"Severe","urgency":"Expected","certainty":"Likely","containsPoint":true}],"wind":{"speedKph":41,"gustKph":67},"computedAt":"2026-07-25T03:16:45Z"}}}},"402":{"description":"Payment required (x402)"}}}},"/wx/ag/{lat}/{lon}":{"get":{"operationId":"wx_ag_{lat}_{lon}","summary":"AGRICULTURAL RISK METRICS for any coordinate — pulls 13 hourly variables from Open-Meteo (4 soil-moisture layers, 2 soil temperatures, ET0 reference evapotranspiration, wind and gusts, humidity, temperature) and synthesizes them into a computed 0-100 ag-risk score with explicit flags for drought, excess precipitation, high wind, high VPD and low soil moisture","description":"AGRICULTURAL RISK METRICS for any coordinate — pulls 13 hourly variables from Open-Meteo (4 soil-moisture layers, 2 soil temperatures, ET0 reference evapotranspiration, wind and gusts, humidity, temperature) and synthesizes them into a computed 0-100 ag-risk score with explicit flags for drought, excess precipitation, high wind, high VPD and low soil moisture. Also returns derived VPD, GDD and ET0. Replicating this means 8+ hourly API calls plus the vapour-pressure-deficit and growing-degree-day math, then reconciling it into one decision. For irrigation scheduling, spray-window selection, harvest timing, crop-insurance triggers and farm-robot go/no-go.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":"40.71"},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":"-74.00"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"lat":40.71,"lon":-74},"agRisk":{"score":38,"level":"moderate","flags":["high_vpd"]},"derived":{"vpdKpa":1.82,"gddToday":14.2,"et0MmDay":4.6},"soil":{"moisture0_1cm":0.21,"moisture1_3cm":0.24,"temp0cm":24.8},"wind":{"speedKph":18,"gustKph":31},"computedAt":"2026-07-25T04:40:00Z"}}}},"402":{"description":"Payment required (x402)"}}}},"/token/risk/{address}":{"get":{"operationId":"token_risk_{address}","summary":"ONE-CALL TOKEN RISK SCORE (0-100): fuses holder concentration from real Transfer logs, Sourcify verification, bytecode analysis, DexScreener liquidity/volume, and recent-recipient distribution into a single verdict (low/medium/high/critical)","description":"ONE-CALL TOKEN RISK SCORE (0-100): fuses holder concentration from real Transfer logs, Sourcify verification, bytecode analysis, DexScreener liquidity/volume, and recent-recipient distribution into a single verdict (low/medium/high/critical). Replaces 5+ chained API calls -- RPC event scans, Sourcify fetch, bytecode download, DexScreener lookup, supply sampling -- plus the scoring logic to weigh them. Answers 'is this token safe to hold?' before an agent commits. Address validated pre-paywall (400, never a charge).","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chain":"base"},"token":{"name":"USD Coin","symbol":"USDC","decimals":6},"risk":{"score":8,"level":"low","flags":[]},"signals":{"verified":true,"holderConcentrationPct":12.4,"liquidityUsd":41200000,"volume24hUsd":8800000,"bytecodeSizeBytes":2842},"computedAt":"2026-07-25T03:16:45Z"}}}},"402":{"description":"Payment required (x402)"}}}},"/wallet/fingerprint/{address}":{"get":{"operationId":"wallet_fingerprint_{address}","summary":"COMPOSITE WALLET FINGERPRINT (0-100) for any Base or Ethereum address: aggregates native balance, transaction count, contract bytecode (is it an EOA or a contract?), ERC-20 token holdings, and DeFi protocol exposure via DefiLlama into one profile plus a score","description":"COMPOSITE WALLET FINGERPRINT (0-100) for any Base or Ethereum address: aggregates native balance, transaction count, contract bytecode (is it an EOA or a contract?), ERC-20 token holdings, and DeFi protocol exposure via DefiLlama into one profile plus a score. Four or more RPC round-trips and the cross-source synthesis, collapsed into one call. Use it to profile a counterparty before trading with them, triage an airdrop list, or check whether an address is a fresh burner or an established participant. Address is validated pre-paywall — a malformed address is a 400, never a charge.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x4200000000000000000000000000000000000006"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"address":"0x4200000000000000000000000000000000000006","chain":"base"},"profile":{"isContract":true,"txCount":184220,"nativeBalanceEth":0,"tokenCount":12},"defi":{"protocolsTouched":3,"topProtocol":"aerodrome"},"fingerprint":{"score":71,"label":"established contract, high activity"},"computedAt":"2026-07-25T03:16:45Z"}}}},"402":{"description":"Payment required (x402)"}}}},"/token/concentration/{address}":{"get":{"operationId":"token_concentration_{address}","summary":"HOLDER CONCENTRATION ANALYTICS for any Base or Ethereum token: fetches real ERC-20 Transfer events from a public RPC, aggregates per-address balances, and computes four statistical measures of holder distribution -- Gini coefficient, top-10% share, Herfindahl-Hirschman Index (HHI), and Shannon entropy","description":"HOLDER CONCENTRATION ANALYTICS for any Base or Ethereum token: fetches real ERC-20 Transfer events from a public RPC, aggregates per-address balances, and computes four statistical measures of holder distribution -- Gini coefficient, top-10% share, Herfindahl-Hirschman Index (HHI), and Shannon entropy. A bot that tries this itself must maintain paginated event parsing across thousands of logs, aggregate transfers per address, and implement the statistical math -- real work that takes ongoing maintenance to keep accurate. One call returns the full concentration profile. Address is validated pre-paywall -- a malformed address is a 400, never a charge.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chain":"base"},"token":{"name":"USD Coin","symbol":"USDC","decimals":6},"concentration":{"gini":0.98,"top10pctShare":0.85,"hhi":7200,"shannonEntropy":3.42,"totalHolders":184320,"totalSupply":"2589012034.000000"},"verdict":"highly concentrated","computedAt":"2026-07-25T11:42:00Z"}}}},"402":{"description":"Payment required (x402)"}}}},"/price":{"get":{"operationId":"price","summary":"Spot crypto price in USD from CoinGecko, normalized to one call","description":"Spot crypto price in USD from CoinGecko, normalized to one call. Saves an agent stitching price feeds from multiple tickers or managing a CoinGecko key; the price is the work completed, not a raw feed to process further.","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"BTC"},"example":"ETH"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"symbol":"BTC-USD","price_usd":63950.12,"source":"coinbase"}}}},"402":{"description":"Payment required (x402)"}}}},"/stock":{"get":{"operationId":"stock","summary":"Stock/ETF quote (price, change, day high/low, volume)","description":"Stock/ETF quote (price, change, day high/low, volume).","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string","default":"AAPL"},"example":"TSLA"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"symbol":"AAPL","price":333.74,"change_pct":0.14,"currency":"USD","source":"yahoo"}}}},"402":{"description":"Payment required (x402)"}}}},"/markets":{"get":{"operationId":"markets","summary":"Top crypto market snapshot by market cap","description":"Top crypto market snapshot by market cap.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":"10"},"example":"10"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"count":10,"coins":[{"symbol":"btc","price_usd":63944,"rank":1,"change_24h_pct":0.5}],"source":"coingecko"}}}},"402":{"description":"Payment required (x402)"}}}},"/signal":{"get":{"operationId":"signal","summary":"Composite market signal: spot + 24h change + momentum → bullish/bearish/neutral verdict","description":"Composite market signal: spot + 24h change + momentum → bullish/bearish/neutral verdict.","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"BTC"},"example":"ETH"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"symbol":"BTC","price_usd":63950,"change_24h_pct":0.5,"momentum":0.42,"verdict":"bullish"}}}},"402":{"description":"Payment required (x402)"}}}},"/onchain/token":{"get":{"operationId":"onchain_token","summary":"On-chain token snapshot: price, liquidity, 24h volume, multi-window price change, FDV, best pool","description":"On-chain token snapshot: price, liquidity, 24h volume, multi-window price change, FDV, best pool. Query by symbol/name or by contract address.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"PEPE"},{"name":"address","in":"query","required":false,"schema":{"type":"string"},"example":"0x6982508145454Ce325dDbE47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","solana","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":"PEPE","chain":"ethereum","token":{"symbol":"PEPE","address":"0x6982…"},"price_usd":0.0000271,"liquidity_usd":14000000,"volume_24h":5200000,"price_change_pct":{"h1":0.3,"h24":-4.6},"dex":"uniswap","source":"dexscreener"}}}},"402":{"description":"Payment required (x402)"}}}},"/onchain/trending":{"get":{"operationId":"onchain_trending","summary":"Trending DEX pools for a chain (name, price, liquidity, 24h volume + change, txns)","description":"Trending DEX pools for a chain (name, price, liquidity, 24h volume + change, txns).","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","solana","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"base","count":15,"pools":[{"name":"BRIAN / ETH","price_usd":0.01,"liquidity_usd":250000,"price_change_24h_pct":12.3}],"source":"geckoterminal"}}}},"402":{"description":"Payment required (x402)"}}}},"/onchain/new":{"get":{"operationId":"onchain_new","summary":"Newly launched DEX pools for a chain — launch hunting","description":"Newly launched DEX pools for a chain — launch hunting. Same shape as trending.","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","solana","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"base","count":15,"pools":[{"name":"NEWCOIN / WETH","created_at":"2026-07-18T02:00:00Z","liquidity_usd":42000}],"source":"geckoterminal"}}}},"402":{"description":"Payment required (x402)"}}}},"/onchain/defi":{"get":{"operationId":"onchain_defi","summary":"One call returns the full DeFi landscape for a chain -- total TVL, top protocols ranked by TVL with category breakdowns (lending, DEX, restaking), and 7-day TVL trend","description":"One call returns the full DeFi landscape for a chain -- total TVL, top protocols ranked by TVL with category breakdowns (lending, DEX, restaking), and 7-day TVL trend. Aggregates DefiLlama across all protocols on the chain so a bot avoids querying DefiLlama's 4+ endpoints per chain, parsing the protocol list, and computing rankings itself.","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","solana","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"base","tvl_usd":4527177464,"top_protocols":[{"name":"Aave V3","category":"Lending","tvl_on_chain_usd":900000000}],"source":"defillama"}}}},"402":{"description":"Payment required (x402)"}}}},"/onchain/safety":{"get":{"operationId":"onchain_safety","summary":"COMPOSITE rug/honeypot score: fuses GoPlus static analysis with a LIVE Honeypot","description":"COMPOSITE rug/honeypot score: fuses GoPlus static analysis with a LIVE Honeypot.is buy/sell simulation, plus a serial-rugger check, hard-zero honeypot gates, and an agreement factor that flags when the two methods disagree. Returns ok/warning/danger + a 0-100 risk score + red/green flags + the raw simulation. More trustworthy than any single free feed. On Solana, fuses GoPlus-Solana + RugCheck (mint/freeze authorities, holder concentration, LP burn) — same dual-engine design.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x6982508145454ce325ddbe47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","bsc","polygon","arbitrum","optimism","solana"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"eth","token":{"symbol":"PEPE"},"verdict":"ok","risk_score":10,"confidence":"high","needs_review":false,"red_flags":["blacklist function present"],"green_flags":["passed live buy & sell simulation","0% simulated buy & sell tax","source code verified","ownership renounced"],"simulation":{"is_honeypot":false,"simulated":true,"buy_tax_pct":0,"sell_tax_pct":0,"risk":"low"},"sources":["goplus (static)","honeypot.is (dynamic sim)"]}}}},"402":{"description":"Payment required (x402)"}}}},"/onchain/liquidity":{"get":{"operationId":"onchain_liquidity","summary":"Liquidity-DRAIN detector from a SELF-COLLECTED reserve time-series (exists nowhere for free — we poll pool reserves over time)","description":"Liquidity-DRAIN detector from a SELF-COLLECTED reserve time-series (exists nowhere for free — we poll pool reserves over time). Answers 'is liquidity leaving this pool right now?' — the earliest sign of a rug or dump in progress. Returns draining_fast/draining/stable/growing + %-change over 1h and the observed window. First call on a cold token returns 404 (uncharged) and starts tracking it; call again once history has built. EVM chains only.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"verdict":"draining_fast","chain":"base","address":"0x4ed4…","liquidity_usd_now":812000,"change_pct_1h":-31.4,"change_pct_window":-44.2,"window_minutes":190,"data_points":63,"note":"liquidity falling fast — possible rug/exit in progress"}}}},"402":{"description":"Payment required (x402)"}}}},"/derivs":{"get":{"operationId":"derivs","summary":"Perp derivatives intel: live funding rate (hourly + annualized), open interest, 24h move, and a crowded-long/short positioning signal","description":"Perp derivatives intel: live funding rate (hourly + annualized), open interest, 24h move, and a crowded-long/short positioning signal.","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"BTC"},"example":"ETH"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"symbol":"BTC","mark_price":63943,"change_24h_pct":0.4,"funding":{"hourly_rate":0.0000125,"annualized_pct":10.95},"open_interest":{"contracts":39322,"usd":2514265000},"signal":"neutral"}}}},"402":{"description":"Payment required (x402)"}}}},"/vet":{"get":{"operationId":"vet","summary":"FLAGSHIP ANSWER: one-call token go/no-go","description":"FLAGSHIP ANSWER: one-call token go/no-go. Fuses DEX market structure + the COMPOSITE rug score (static + LIVE buy/sell simulation + serial-rugger) + our self-collected LIQUIDITY-DRAIN trend into one verdict your agent acts on directly: clear / caution / avoid, with reasons. Replaces 4+ raw lookups and the inference to reconcile them; catches honeypots and rugs-in-progress a single free feed misses. Supports EVM chains AND Solana.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x6982508145454ce325ddbe47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","bsc","polygon","arbitrum","optimism","solana"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"verdict":"avoid","confidence":"high","why":["security: high simulated sell tax 35%","liquidity: draining fast (-31.4% over 190m) — possible rug in progress"],"token":{"symbol":"SCAMCOIN"},"market":{"price_usd":0.0000041,"liquidity_usd":812000},"security":{"risk_score":40,"needs_review":false,"red_flags":["high simulated sell tax 35%"],"simulation":{"is_honeypot":false,"sell_tax_pct":35}},"liquidity_trend":{"verdict":"draining_fast","change_pct_1h":-31.4,"window_minutes":190}}}}},"402":{"description":"Payment required (x402)"}}}},"/brief":{"get":{"operationId":"brief","summary":"ANSWER: one-call market regime read for a symbol","description":"ANSWER: one-call market regime read for a symbol. Spot + 24h move + perp funding/OI + market sentiment distilled to risk_on / risk_off / neutral with reasons. One call arms a trading agent's context window.","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"BTC"},"example":"ETH"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"regime":"neutral","symbol":"BTC","why":["24h move +0.4%","funding 10.95% annualized — balanced","sentiment 25/100 (Extreme Fear)"],"price_usd":63950,"derivatives":{"funding_annualized_pct":10.95,"positioning":"neutral"},"sentiment":{"value":25,"label":"Extreme Fear"}}}}},"402":{"description":"Payment required (x402)"}}}},"/screen":{"get":{"operationId":"screen","summary":"ANSWER: batch rug/safety screen","description":"ANSWER: batch rug/safety screen. Give a chain and up to 8 token addresses; get each token's verdict + risk score (unordered), plus a clear/caution/avoid summary. Screen a watchlist or the newest launches in one call.","parameters":[{"name":"addresses","in":"query","required":true,"schema":{"type":"string"},"example":"0x6982508145454ce325ddbe47a25d4ec3d2311933,0x4200000000000000000000000000000000000006"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","eth","bsc","polygon","arbitrum","optimism"],"default":"base"}}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"base","summary":{"screened":2,"clear":1,"caution":1,"avoid":0},"tokens":[{"symbol":"WETH","verdict":"ok","risk_score":0}]}}}},"402":{"description":"Payment required (x402)"}}}},"/etf/flows":{"get":{"operationId":"etf_flows","summary":"Skip parsing 10+ SEC filings and Yahoo Finance feeds yourself -- one call returns volume-weighted net flow estimates for US spot BTC/ETH ETFs with same-day freshness (SEC N-PORT lags T+30)","description":"Skip parsing 10+ SEC filings and Yahoo Finance feeds yourself -- one call returns volume-weighted net flow estimates for US spot BTC/ETH ETFs with same-day freshness (SEC N-PORT lags T+30). Aggregates 10+ OHLCV sources and does the flow math so a bot saves ~15 minutes of multi-source fetch + computation per query.","parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"string"},"example":"IBIT,FBTC,ARKB"},{"name":"days","in":"query","required":false,"schema":{"type":"string","default":"5"},"example":"5"}],"x-payment-info":{"protocols":[{"scheme":"exact","network":"eip155:8453","asset":"USDC"}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"as_of":"2026-07-25","symbols_queried":["IBIT","FBTC","ARKB"],"total_net_flow_usd":125000000,"per_symbol":[{"symbol":"IBIT","net_flow_usd":80000000,"close":57.32,"volume":12000000},{"symbol":"FBTC","net_flow_usd":30000000,"close":55.1,"volume":4500000},{"symbol":"ARKB","net_flow_usd":15000000,"close":52.8,"volume":2100000}],"source":"Yahoo Finance OHLCV","methodology":"volume-weighted price-action estimate"}}}},"402":{"description":"Payment required (x402)"}}}}}}