{"uid":"cap_81xHQnVwIhrgxnTXbqFqj","slug":"speraxos-erc-8004-subgraph-query-api-f83c8909","name":"SperaxOS ERC-8004 Subgraph Query API","description":"AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.","url":"https://chat.sperax.io/api/x402/v1/erc8004/subgraph?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string"},"query":{"type":"string","maxLength":10000,"minLength":1},"variables":{"type":"object","additionalProperties":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mFMa_x3mfFw7xMbya2PvJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0xD74f5255D557944cf7Dd0E45FF521520002D5748","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes GraphQL queries against DeFi subgraph data for a specified blockchain chain, paid per-request via x402/USDC","exampleAgentPrompt":"Query the SperaxOS subgraph on Base chain to get the top 10 liquidity pools by TVL — use this GraphQL: { pools(first: 10, orderBy: totalValueLockedUSD, orderDirection: desc) { id token0 { symbol } token1 { symbol } totalValueLockedUSD } }","exampleUseCases":[{"title":"Top liquidity pools by TVL","prompt":"Fetch the top 10 liquidity pools by total value locked on Base using the SperaxOS subgraph — run a GraphQL query for pool IDs, token pairs, and their TVL in USD."},{"title":"Wallet DeFi position lookup","prompt":"Query the SperaxOS subgraph on Base to get all open DeFi positions for wallet address 0xABC123... — I need the pool, deposited amounts, and current value."},{"title":"Recent token swap history","prompt":"Pull the last 50 token swap events from the SperaxOS subgraph on Base chain — give me the transaction hash, tokens swapped, amounts, and timestamps."}],"resultDescription":"Returns the raw GraphQL query result from the target chain's subgraph, including matched on-chain entities such as pools, positions, swaps, tokens, or protocol metrics as structured JSON data fields.","failureModes":["Invalid or malformed GraphQL query syntax returns a GraphQL error response","Unsupported or unknown chain identifier results in a 400 or empty response","Query exceeds 10,000 character limit and is rejected","Insufficient USDC payment or x402 payment failure blocks the request","Variables object does not match query expectations causing a runtime GraphQL error","Subgraph indexing lag may return stale data for very recent on-chain events"],"whenToPreferThis":"Choose this endpoint when you need to run arbitrary GraphQL queries against DeFi subgraph data on a specific blockchain chain without managing API keys — ideal for agents that pay per-call with USDC and need flexible, schema-driven access to on-chain protocol data such as pools, swaps, positions, or token metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:37:35.042Z","isFirstParty":false,"canonicalSlug":"speraxos-erc-8004-subgraph-query-api-f83c8909"}