{ "openapi": "3.1.0", "info": { "title": "VerifyOracle", "version": "1.2.0", "description": "Primary-source verifiable x402 API oracle on Base Mainnet USDC.", "x-guidance": "Call GET /api/crypto-price, /api/base-gas, /api/block-number, /api/erc20-balance, /api/fx-rate, /api/weather, /api/solana-mint-audit, or /api/bounties. Unpaid requests return HTTP 402 with x402 v2 PAYMENT-REQUIRED and v1 X-PAYMENT-REQUIRED challenge headers settling in Base Mainnet USDC." }, "servers": [ { "url": "https://verify-oracle.run402.com" } ], "paths": { "/api/health": { "get": { "operationId": "health_check", "security": [], "summary": "Health check" } }, "/api/status": { "get": { "operationId": "settlement_status", "security": [], "summary": "Public x402 settlement ledger" } }, "/api/crypto-price": { "get": { "operationId": "crypto_price", "summary": "Live cryptocurrency spot price feed in USD (BTC price, ETH price, SOL price) from Coinbase and Kraken primary exchange spot books.", "tags": [ "crypto-price", "btc-price", "spot-price", "coinbase", "kraken", "oracle" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "1000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [ { "name": "symbol", "in": "query", "required": false, "description": "Trading pair or asset symbol (default BTC-USD)", "schema": { "type": "string", "default": "BTC-USD", "example": "BTC-USD" } }, { "name": "ticker", "in": "query", "required": false, "description": "Optional ticker alias (e.g. BTCUSD)", "schema": { "type": "string", "default": "BTCUSD", "example": "BTCUSD" } }, { "name": "pair", "in": "query", "required": false, "description": "Optional pair alias (e.g. BTC-USD)", "schema": { "type": "string", "default": "BTC-USD", "example": "BTC-USD" } }, { "name": "coin", "in": "query", "required": false, "description": "Optional coin name alias (e.g. bitcoin)", "schema": { "type": "string", "default": "bitcoin", "example": "bitcoin" } } ], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string" }, "base": { "type": "string" }, "quote": { "type": "string" }, "price": { "type": "number" }, "value": { "type": "number" }, "spot": { "type": "number" }, "currency": { "type": "string" }, "sources": { "type": "object" }, "source": { "type": "string" }, "timestamp": { "type": "string" } }, "example": { "symbol": "BTC-USD", "base": "BTC", "quote": "USD", "price": 95000.25, "value": 95000.25, "spot": 95000.25, "currency": "USD", "sources": { "coinbase": 95000.5, "kraken": 95000 }, "source": "coinbase-kraken-median", "timestamp": "2026-10-21T18:00:00.000Z" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/base-gas": { "get": { "operationId": "base_gas", "summary": "Live Base Mainnet (chainId 8453) gas price, EIP-1559 base fee in gwei, and block number directly from Base Mainnet RPC.", "tags": [ "gas-price", "base-fee", "gwei", "base", "rpc", "onchain" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "1000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [ { "name": "chain", "in": "query", "required": false, "description": "Target chain (default base)", "schema": { "type": "string", "default": "base", "example": "base" } } ], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "chainId": { "type": "number" }, "chain": { "type": "string" }, "network": { "type": "string" }, "price": { "type": "number" }, "value": { "type": "number" }, "baseFeeGwei": { "type": "number" }, "baseFeePerGasGwei": { "type": "number" }, "baseFeePerGasWei": { "type": "string" }, "priorityFeeGwei": { "type": "number" }, "blockNumber": { "type": "number" }, "blockTimestamp": { "type": "number" }, "source": { "type": "string" }, "timestamp": { "type": "string" } }, "example": { "chainId": 8453, "chain": "base", "network": "base-mainnet", "price": 0.0012, "value": 0.0012, "baseFeeGwei": 0.0012, "baseFeePerGasGwei": 0.0012, "baseFeePerGasWei": "1200000", "priorityFeeGwei": 0.0003, "blockNumber": 52908000, "blockTimestamp": 1761069000, "source": "base-mainnet-rpc", "timestamp": "2026-10-21T18:00:00.000Z" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/block-number": { "get": { "operationId": "block_number", "summary": "Live Base Mainnet (chainId 8453) latest block height, block hash, UTC timestamp, and transaction count from Base RPC.", "tags": [ "onchain-data", "block-height", "base", "rpc", "onchain" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "1000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "chainId": { "type": "number" }, "network": { "type": "string" }, "blockNumber": { "type": "number" }, "blockHash": { "type": "string" }, "parentHash": { "type": "string" }, "timestamp": { "type": "number" }, "timestampIso": { "type": "string" }, "txCount": { "type": "number" }, "baseFeePerGasWei": { "type": "string" }, "source": { "type": "string" } }, "example": { "chainId": 8453, "network": "base-mainnet", "blockNumber": 52908000, "blockHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", "parentHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890", "timestamp": 1761069000, "timestampIso": "2026-10-21T18:00:00.000Z", "txCount": 142, "baseFeePerGasWei": "1200000", "source": "base-mainnet-rpc" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/erc20-balance": { "get": { "operationId": "erc20_balance", "summary": "Live on-chain wallet balance and ERC20 balanceOf holdings on Base Mainnet (defaults to Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913).", "tags": [ "wallet-balance", "token-balance", "erc20", "usdc", "base", "holdings" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "1000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [ { "name": "address", "in": "query", "required": false, "description": "0x wallet address on Base (default vitalik.eth)", "schema": { "type": "string", "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" } }, { "name": "wallet", "in": "query", "required": false, "description": "Alias for address", "schema": { "type": "string", "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" } }, { "name": "account", "in": "query", "required": false, "description": "Alias for address", "schema": { "type": "string", "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" } }, { "name": "contract", "in": "query", "required": false, "description": "0x ERC-20 contract on Base (default USDC)", "schema": { "type": "string", "default": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "example": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } ], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "chainId": { "type": "number" }, "network": { "type": "string" }, "address": { "type": "string" }, "contract": { "type": "string" }, "balance": { "type": "number" }, "usd": { "type": "number" }, "value": { "type": "number" }, "balanceFormatted": { "type": "string" }, "balanceNumber": { "type": "number" }, "atomicUnits": { "type": "string" }, "decimals": { "type": "number" }, "source": { "type": "string" }, "timestamp": { "type": "string" } }, "example": { "chainId": 8453, "network": "base-mainnet", "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "balance": 25.5, "usd": 25.5, "value": 25.5, "balanceFormatted": "25.500000", "balanceNumber": 25.5, "atomicUnits": "25500000", "decimals": 6, "source": "base-mainnet-rpc", "timestamp": "2026-10-21T18:00:00.000Z" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/fx-rate": { "get": { "operationId": "fx_rate", "summary": "Live forex fx rate and fiat reference exchange rate for currency conversion from the European Central Bank (ECB eurofxref-daily, default EUR/USD).", "tags": [ "fx-rate", "forex", "exchange-rate", "ecb", "fiat", "eur-usd" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "1000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [ { "name": "from", "in": "query", "required": false, "description": "Base currency ISO code (default EUR)", "schema": { "type": "string", "default": "EUR", "example": "EUR" } }, { "name": "to", "in": "query", "required": false, "description": "Quote currency ISO code (default USD)", "schema": { "type": "string", "default": "USD", "example": "USD" } }, { "name": "base", "in": "query", "required": false, "description": "Alias for base currency (default EUR)", "schema": { "type": "string", "default": "EUR", "example": "EUR" } }, { "name": "symbol", "in": "query", "required": false, "description": "Pair symbol (default EURUSD)", "schema": { "type": "string", "default": "EURUSD", "example": "EURUSD" } }, { "name": "pair", "in": "query", "required": false, "description": "Pair string (default EUR/USD)", "schema": { "type": "string", "default": "EUR/USD", "example": "EUR/USD" } } ], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "pair": { "type": "string" }, "symbol": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" }, "rate": { "type": "number" }, "price": { "type": "number" }, "value": { "type": "number" }, "ecbReferenceDate": { "type": "string" }, "source": { "type": "string" }, "timestamp": { "type": "string" } }, "example": { "pair": "EUR/USD", "symbol": "EURUSD", "from": "EUR", "to": "USD", "rate": 1.0852, "price": 1.0852, "value": 1.0852, "ecbReferenceDate": "2026-10-21", "source": "ecb-eurofxref-daily", "timestamp": "2026-10-21T18:00:00.000Z" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/weather": { "get": { "operationId": "weather", "summary": "Live weather forecast and current temperature in Fahrenheit and Celsius with precipitation and wind from Open-Meteo and NWS (default New York).", "tags": [ "weather", "temperature", "forecast", "meteo", "precipitation" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "1000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [ { "name": "location", "in": "query", "required": false, "description": "City or location name (default New York)", "schema": { "type": "string", "default": "New York", "example": "New York" } }, { "name": "city", "in": "query", "required": false, "description": "Alias for location", "schema": { "type": "string", "default": "New York", "example": "New York" } }, { "name": "q", "in": "query", "required": false, "description": "Alias for location", "schema": { "type": "string", "default": "New York", "example": "New York" } }, { "name": "lat", "in": "query", "required": false, "description": "Optional latitude (default 40.7128)", "schema": { "type": "number", "default": 40.7128, "example": 40.7128 } }, { "name": "lon", "in": "query", "required": false, "description": "Optional longitude (default -74.0060)", "schema": { "type": "number", "default": -74.006, "example": -74.006 } } ], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "value": { "type": "number" }, "temp": { "type": "number" }, "temperatureFahrenheit": { "type": "number" }, "temperatureCelsius": { "type": "number" }, "unit": { "type": "string" }, "humidityPercent": { "type": "number" }, "precipitationInch": { "type": "number" }, "windSpeedMph": { "type": "number" }, "source": { "type": "string" }, "timestamp": { "type": "string" } }, "example": { "location": "New York", "latitude": 40.7128, "longitude": -74.006, "value": 65.1, "temp": 65.1, "temperatureFahrenheit": 65.1, "temperatureCelsius": 18.4, "unit": "fahrenheit", "humidityPercent": 55, "precipitationInch": 0, "windSpeedMph": 7.2, "source": "open-meteo-primary", "timestamp": "2026-10-21T18:00:00.000Z" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/solana-mint-audit": { "get": { "operationId": "solana_mint_audit", "summary": "Live Solana Mainnet-Beta SPL Token / Token-2022 mint security audit (mintAuthority, freezeAuthority, supply, decimals, riskScore).", "tags": [ "solana", "spl-token", "security", "audit" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "2000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [ { "name": "mint", "in": "query", "required": false, "description": "Solana SPL token mint address", "schema": { "type": "string", "default": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" } } ], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string" }, "exists": { "type": "boolean" }, "program": { "type": "string" }, "owner": { "type": "string" }, "decimals": { "type": "number" }, "supply": { "type": "string" }, "isInitialized": { "type": "boolean" }, "mintAuthority": { "type": "string" }, "freezeAuthority": { "type": "string" }, "mintAuthorityRevoked": { "type": "boolean" }, "freezeAuthorityRevoked": { "type": "boolean" }, "riskScore": { "type": "number" }, "verdict": { "type": "string" }, "reasons": { "type": "array" }, "source": { "type": "string" }, "timestamp": { "type": "string" } }, "example": { "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "exists": true, "program": "spl-token", "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", "decimals": 6, "supply": "1000000000000000", "isInitialized": true, "mintAuthority": "2wmVCSfPxGPjrnMMn7rchp4uaeoTqN39mXFC2zhPdri9", "freezeAuthority": "3sNBr7kMccME5D55xNgsmYpYnEwPgP2g12C6VqQqgK6n", "mintAuthorityRevoked": false, "freezeAuthorityRevoked": false, "riskScore": 70, "verdict": "HIGH_RISK", "reasons": [ "Mint authority is active", "Freeze authority is active" ], "source": "solana-mainnet-rpc", "timestamp": "2026-10-21T18:00:00.000Z" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } }, "/api/bounties": { "get": { "operationId": "bounties", "summary": "Curated feed of active, verified cash/crypto coding and agent bounties across GitHub, Frantic, and SwarmMemo.", "tags": [ "bounties", "github", "agents", "usdc" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002" }, "protocols": [ { "x402": {} } ], "pricingMode": "fixed", "amount": "2000", "currency": "USD", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3" }, "parameters": [], "responses": { "200": { "description": "Paid primary-source oracle response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "number" }, "updatedAt": { "type": "string" }, "bounties": { "type": "array" }, "source": { "type": "string" } }, "example": { "count": 4, "updatedAt": "2026-10-21T18:00:00.000Z", "bounties": [ { "id": "go-hybrid-bounty-ladder", "repo": "limitlessprojects/Go-Hybrid", "rewardUsd": "50-500", "currency": "USD / Crypto", "status": "ACTIVE" } ], "source": "bounty-radar" } } } } }, "402": { "description": "Payment Required (x402 v1 X-PAYMENT-REQUIRED & v2 PAYMENT-REQUIRED headers)" } } } } } }