{ "openapi": "3.1.0", "info": { "title": "chainpulse", "description": "Real-time crypto market data for AI agents: prices, multichain gas, DeFi TVL. Pay per call with x402 (USDC on Base). No signup, no API key.", "version": "1.0.0", "contact": { "email": "constant-7997@agentmail.to" } }, "servers": [ { "url": "https://md.fastdb.in/pulse" } ], "paths": { "/price": { "post": { "operationId": "crypto-price", "summary": "Real-time crypto prices (USD)", "description": "Spot USD prices for any of the majors by symbol, any CoinGecko id, or any token by chain:address. Aggregated with a confidence score, ~15s freshness.", "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "coins": { "type": "array", "items": { "type": "string" }, "maxItems": 25, "description": "Symbols (BTC, ETH, SOL, USDC, USDT, DAI, BNB, XRP, ...), \"coingecko:\", or \":\".", "example": [ "ETH", "BTC" ] } }, "required": [ "coins" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Real-time crypto prices (USD)", "content": { "application/json": { "schema": { "type": "object", "properties": { "prices": {}, "at": {}, "source": {}, "ms": {} }, "example": { "prices": { "ETH": { "usd": 1818.32, "symbol": "ETH", "confidence": 0.99, "key": "coingecko:ethereum" }, "BTC": { "usd": 63164.1, "symbol": "BTC", "confidence": 0.99, "key": "coingecko:bitcoin" } }, "at": "2026-07-17T15:00:00.000Z", "source": "defillama" } } } } }, "400": { "description": "Bad request — unknown coin, chain, or protocol." }, "402": { "description": "Payment required. Body carries x402 payment requirements; retry with an X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/gas": { "post": { "operationId": "gas-price", "summary": "Live gas across 5 chains", "description": "Current gas price, next-block base fee, and slow/standard/fast priority fees straight from chain RPC — plus the USD cost of a transfer so agents can compare chains without unit math. Ethereum, Base, Arbitrum, Optimism, Polygon.", "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chains": { "type": "array", "items": { "type": "string", "enum": [ "ethereum", "base", "arbitrum", "optimism", "polygon" ] }, "description": "Chains to quote. Omit for all supported chains.", "example": [ "base", "ethereum" ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Live gas across 5 chains", "content": { "application/json": { "schema": { "type": "object", "properties": { "gas": {}, "chains": {}, "at": {}, "ms": {} }, "example": { "gas": { "base": { "chain": "base", "blockNumber": 48755195, "gasPriceGwei": 0.006, "baseFeeGwei": 0.005, "priorityFee": { "slowGwei": 0.0001, "standardGwei": 0.0011, "fastGwei": 0.019 }, "nativeSymbol": "ETH", "nativeUsd": 1818.32, "transferCostUsd": 0.0002291 } }, "chains": [ "base" ], "at": "2026-07-17T15:00:00.000Z" } } } } }, "400": { "description": "Bad request — unknown coin, chain, or protocol." }, "402": { "description": "Payment required. Body carries x402 payment requirements; retry with an X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/tvl": { "post": { "operationId": "defi-tvl", "summary": "DeFi protocol TVL (USD)", "description": "Current total value locked for any DeFi protocol by its DefiLlama slug.", "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "protocols": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "DefiLlama protocol slugs.", "example": [ "uniswap", "aave" ] } }, "required": [ "protocols" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "DeFi protocol TVL (USD)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tvl": {}, "at": {}, "source": {}, "ms": {} }, "example": { "tvl": { "uniswap": { "usd": 3067634352.49 }, "aave": { "usd": 24500000000 } }, "at": "2026-07-17T15:00:00.000Z", "source": "defillama" } } } } }, "400": { "description": "Bad request — unknown coin, chain, or protocol." }, "402": { "description": "Payment required. Body carries x402 payment requirements; retry with an X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/odds": { "post": { "operationId": "polymarket-odds", "summary": "Polymarket prediction market odds: live prices for any market by search or slug", "description": "Live Polymarket odds normalized for agents: search any topic (\"fed rate cut\", \"world cup\") or fetch one market by slug. Returns outcomes, prices, bid/ask spread, 24h volume, liquidity, and resolution date. ~15s freshness.", "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "maxLength": 200, "description": "Free-text search across Polymarket markets.", "example": "argentina world cup" }, "slug": { "type": "string", "description": "Exact Polymarket market slug (alternative to query)." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Polymarket prediction market odds: live prices for any market by search or slug", "content": { "application/json": { "schema": { "type": "object", "properties": { "markets": {}, "query": {}, "source": {}, "ms": {} }, "example": { "markets": [ { "question": "Will Argentina win the 2026 FIFA World Cup?", "slug": "will-argentina-win-the-2026-fifa-world-cup", "outcomes": [ "Yes", "No" ], "prices": [ 0.4055, 0.5945 ], "bestBid": 0.404, "bestAsk": 0.407, "spread": 0.003, "oneDayPriceChange": 0.021, "volume24h": 3276661, "liquidity": 812000, "endDate": "2026-07-20T00:00:00Z", "active": true, "url": "https://polymarket.com/market/will-argentina-win-the-2026-fifa-world-cup" } ], "query": "argentina world cup", "source": "polymarket" } } } } }, "400": { "description": "Bad request — unknown coin, chain, or protocol." }, "402": { "description": "Payment required. Body carries x402 payment requirements; retry with an X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/movers": { "post": { "operationId": "polymarket-movers", "summary": "Polymarket biggest movers: prediction markets with the largest 24h odds swings", "description": "The prediction markets that moved most in the last 24 hours, filtered to liquid markets (default $10k+ daily volume). The fastest way for an agent to spot where consensus is shifting. ~15s freshness.", "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 }, "minVolume24h": { "type": "number", "minimum": 0, "default": 10000, "description": "Ignore markets below this 24h USD volume." } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Polymarket biggest movers: prediction markets with the largest 24h odds swings", "content": { "application/json": { "schema": { "type": "object", "properties": { "movers": {}, "minVolume24h": {}, "source": {}, "ms": {} }, "example": { "movers": [ { "question": "Will France win on 2026-07-18?", "prices": [ 0.495, 0.505 ], "oneDayPriceChange": -0.11, "volume24h": 800800 } ], "minVolume24h": 10000, "source": "polymarket" } } } } }, "400": { "description": "Bad request — unknown coin, chain, or protocol." }, "402": { "description": "Payment required. Body carries x402 payment requirements; retry with an X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/resolving": { "post": { "operationId": "polymarket-resolving", "summary": "Polymarket markets resolving soon: active prediction markets ending within N hours", "description": "Active Polymarket markets that resolve within your window (default 24h), sorted by volume. For agents hunting near-resolution opportunities or tracking imminent event outcomes. ~15s freshness.", "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "hours": { "type": "number", "exclusiveMinimum": 0, "maximum": 720, "default": 24, "description": "Window: markets ending within this many hours." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Polymarket markets resolving soon: active prediction markets ending within N hours", "content": { "application/json": { "schema": { "type": "object", "properties": { "resolving": {}, "withinHours": {}, "source": {}, "ms": {} }, "example": { "resolving": [ { "question": "France vs. England: Team to Win", "prices": [ 0.645, 0.355 ], "volume24h": 1181760, "endDate": "2026-07-18T22:00:00Z" } ], "withinHours": 24, "source": "polymarket" } } } } }, "400": { "description": "Bad request — unknown coin, chain, or protocol." }, "402": { "description": "Payment required. Body carries x402 payment requirements; retry with an X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } } }, "x-payment-recipient": "0x072F3a2bD93bB75b1Eb84a9E45D17a4F90a6D801" }