{"uid":"cap_rpSakncriSUM5Nq51-gYA","slug":"agenticfi-defi-positions-by-wallet-address-62bade24","name":"AgenticFi DeFi Positions by Wallet Address","description":"DeFi APIs for AI agents. 36 pay-per-call endpoints for token data, pricing, wallet analytics, swap routing, and on-chain workflows. Powered by x402 on Base.","url":"https://defi-api.agenticfi.wtf/api/wallet/defi-positions/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","pathParams","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"}}},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain key Examples: base, ethereum, arbitrum"},"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zU0uwy2S92DR4j-va4ovz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all active DeFi positions held by a given wallet address on a specified chain","exampleAgentPrompt":"What DeFi positions does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e currently hold on Base — show me all the protocols and amounts they're in.","exampleUseCases":null,"resultDescription":"A structured list of active DeFi positions associated with the queried wallet address, including protocol names, position types (e.g. liquidity, staking, lending), asset amounts, and chain context.","failureModes":["Invalid or malformed wallet address returns a 400 or validation error","Wallet address has no DeFi positions — returns empty array or 404","Unsupported chain key returns error or no results","Payment failure (x402) if USDC balance or payment authorization is insufficient","Rate limiting or service unavailability returns 5xx"],"whenToPreferThis":"Use this endpoint when you need a comprehensive snapshot of all DeFi positions for a specific wallet address on Base, Ethereum, Arbitrum, or other supported chains. Prefer it over general token balance endpoints when you specifically need protocol-level positions like LP shares, staked tokens, or lending collateral rather than raw token holdings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:16.825Z","isFirstParty":false}