{"uid":"cap_cTm4dPdBMsiPS25ex7rb0","slug":"gateway-spraay-app-ca5c88c6","name":"Spraay DeFi Positions Lookup","description":"On-chain DeFi positions across Aave V3, Compound V3, Aerodrome on Base.","url":"https://gateway.spraay.app/api/v1/defi/positions","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string"},"address":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"address":{"type":"string"},"positions":{"type":"array"},"total_positions":{"type":"number"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"base-mainnet","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}},"response":{"chain":"base-mainnet","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","_gateway":{"endpoint":"defi/positions","price_usdc":"0.02","protocols_checked":["aave-v3","compound-v3","aerodrome"],"upstream_latency_ms":92},"positions":[],"by_protocol":{},"partial_errors":[{"message":"bad address checksum (argument=\"address\", value=\"0x174446a6741ff0dAcBC3b4464f25c497E58F1fE8\", code=INVALID_ARGUMENT, version=6.16.0)","protocol":"aave-v3"},{"message":"bad address checksum (argument=\"address\", value=\"0x4e829F8A5213c42535AB84AA40BD4aDCCe9cBa02\", code=INVALID_ARGUMENT, version=6.16.0)","protocol":"aerodrome"}],"total_positions":0,"protocols_with_exposure":[]}},"exampleRequest":{"chain":"base-mainnet","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zEFXdIF_6THDxG_HtjHPW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain DeFi positions for a wallet address across Aave V3, Compound V3, and Aerodrome on Base chain","exampleAgentPrompt":"What DeFi positions does wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 have open right now — check Aave V3, Compound V3, and Aerodrome on Base?","exampleUseCases":null,"resultDescription":"Returns a list of on-chain DeFi positions for the queried wallet address, including position details across Aave V3, Compound V3, and Aerodrome protocols on Base, along with total position count.","failureModes":["Missing required 'address' query param returns a validation error","Invalid or malformed wallet address returns an error or empty positions array","Unsupported chain identifier may return no results or an error","Payment not included or insufficient USDC (x402) returns 402 Payment Required","Network or RPC unavailability may cause timeouts or partial data"],"whenToPreferThis":"Use this endpoint when you need to aggregate a wallet's DeFi positions specifically across Aave V3, Compound V3, and Aerodrome on the Base network in a single call. Prefer this over manual RPC calls or protocol-specific APIs when you want a unified view of lending, borrowing, and liquidity positions for any address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:54:54.657Z","isFirstParty":false}