{"openapi":"3.1.0","info":{"title":"Grey Ridge Signals — x402 Data & Security APIs","version":"1.0.0","description":"Agent-native pay-per-call data on Base (USDC via x402). No API keys, no signup. Discovery: /.well-known/x402"},"servers":[{"url":"https://x402-data-api.sigrunner.workers.dev"}],"paths":{"/":{"get":{"summary":"Landing page (HTML, free).","description":"Self-contained HTML landing page — pitch, endpoint-group pricing table, free curl sample, MCP install snippet, discovery links. No payment required.","responses":{"200":{"description":"HTML landing page"}}}},"/crypto/prices":{"get":{"summary":"Spot token prices + change_24h (DefiLlama).","description":"Spot token prices + change_24h (DefiLlama). Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"coins","in":"query","required":false,"schema":{"type":"string"},"description":"comma-separated coingecko ids (max 25)"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/crypto/funding":{"get":{"summary":"Cross-venue Hyperliquid+OKX+dYdX funding rates + arb spread + premium/annualized/signal/next_funding_ts.","description":"Cross-venue Hyperliquid+OKX+dYdX funding rates + arb spread + premium/annualized/signal/next_funding_ts. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"max coins (default 20, max 100)"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/defi/yields":{"get":{"summary":"Top DeFi lending/LP yields — APY trend + IL risk + reward/underlying tokens + mu/sigma + stability forecast (DefiLlama).","description":"Top DeFi lending/LP yields — APY trend + IL risk + reward/underlying tokens + mu/sigma + stability forecast (DefiLlama). Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"max pools"},{"name":"project","in":"query","required":false,"schema":{"type":"string"},"description":"protocol filter"},{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"chain filter"},{"name":"stable","in":"query","required":false,"schema":{"type":"string"},"description":"'true' = stablecoin only"},{"name":"sort","in":"query","required":false,"schema":{"type":"string"},"description":"'tvl' (default) or 'risk_adjusted' (apy/sigma)"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/pm/markets":{"get":{"summary":"Live Polymarket prediction markets, ranked by volume24hr, with bestBid/bestAsk/spread and category tags.","description":"Live Polymarket prediction markets, ranked by volume24hr, with bestBid/bestAsk/spread and category tags. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.005.","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"keyword filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"max markets"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.005 USDC via x402)"}}}},"/scan/mcp":{"get":{"summary":"Security audit of an MCP server (tool-poisoning / prompt-injection). Findings + risk score + verdict (clear/review/block).","description":"Security audit of an MCP server (tool-poisoning / prompt-injection). Findings + risk score + verdict (clear/review/block). Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.10.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"target MCP server URL"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.10 USDC via x402)"}}}},"/enrich/tech-risk":{"get":{"summary":"Tech-stack -> CVE + EPSS + CISA-KEV risk + verdict (clear/review/block).","description":"Tech-stack -> CVE + EPSS + CISA-KEV risk + verdict (clear/review/block). Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.05.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"target domain"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.05 USDC via x402)"}}}},"/enrich/domain":{"get":{"summary":"Firmographic + tech-stack enrichment, incl. subdomain enumeration + verdict (clear/review/block, domain age).","description":"Firmographic + tech-stack enrichment, incl. subdomain enumeration + verdict (clear/review/block, domain age). Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.01.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"target domain"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.01 USDC via x402)"}}}},"/chain/block-number":{"get":{"summary":"Current Base mainnet block number.","description":"Current Base mainnet block number. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/gas-price":{"get":{"summary":"Current Base mainnet gas price (wei/gwei), EIP-1559 base_fee_gwei/priority_fee_gwei, gas_price_usd.","description":"Current Base mainnet gas price (wei/gwei), EIP-1559 base_fee_gwei/priority_fee_gwei, gas_price_usd. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/balance":{"get":{"summary":"ETH balance of a Base mainnet address, incl. balance_usd.","description":"ETH balance of a Base mainnet address, incl. balance_usd. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed Base address"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/token-balance":{"get":{"summary":"ERC-20 token balance of a Base mainnet address, incl. symbol/decimals/balance_formatted.","description":"ERC-20 token balance of a Base mainnet address, incl. symbol/decimals/balance_formatted. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed holder address"},{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed ERC-20 contract address"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/tx":{"get":{"summary":"Transaction details by hash on Base mainnet.","description":"Transaction details by hash on Base mainnet. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"hash","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed 32-byte transaction hash"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/receipt":{"get":{"summary":"Transaction receipt by hash on Base mainnet: status, gas used, full logs, L1 fee breakdown, l1_fee_usd/total_fee_usd.","description":"Transaction receipt by hash on Base mainnet: status, gas used, full logs, L1 fee breakdown, l1_fee_usd/total_fee_usd. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"hash","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed 32-byte transaction hash"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/code":{"get":{"summary":"Contract-code check for a Base mainnet address (EIP-7702 delegated-EOA aware).","description":"Contract-code check for a Base mainnet address (EIP-7702 delegated-EOA aware). Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.001.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed Base address"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.001 USDC via x402)"}}}},"/chain/wallet":{"get":{"summary":"Wallet bundle: ETH balance + balance_usd + tx count + contract-code check (EIP-7702 delegated-EOA aware), in one call.","description":"Wallet bundle: ETH balance + balance_usd + tx count + contract-code check (EIP-7702 delegated-EOA aware), in one call. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.003.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed Base address"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.003 USDC via x402)"}}}},"/chain/token-security":{"get":{"summary":"Token security / honeypot detector: EIP-1967/1822 proxy + upgradeability detection, bytecode scan for mint/pause/blacklist/fee-setter/ownership selectors, owner() renouncement check, live eth_call state-override transfer simulation. Returns risk_score + verdict (clear/review/block) + flags.","description":"Token security / honeypot detector: EIP-1967/1822 proxy + upgradeability detection, bytecode scan for mint/pause/blacklist/fee-setter/ownership selectors, owner() renouncement check, live eth_call state-override transfer simulation. Returns risk_score + verdict (clear/review/block) + flags. Paid via x402 (USDC on Base, eip155:8453). Returns HTTP 402 with a payment-required challenge until paid. Price: $0.02.","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"0x-prefixed ERC-20 contract address on Base mainnet"}],"responses":{"200":{"description":"Success — JSON data"},"402":{"description":"Payment required ($0.02 USDC via x402)"}}}}}}