{"uid":"cap_lgvECK33iDCCeyrIUPal4","slug":"defi-shield-hazel-vercel-app-1e936152","name":"DeFi Shield Wallet Position Analyzer","description":"","url":"https://defi-shield-hazel.vercel.app/api/monitor/position","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"properties":{"token_address":{"type":"string","description":"Token contract address (0x + 40 hex chars)"},"wallet_address":{"type":"string","description":"Wallet address holding the position (0x + 40 hex chars)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{"token_address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","wallet_address":"0xAbCdEf1234567890AbCdEf1234567890AbCdEf12"},"type":"http","method":"POST","bodyType":"json"}},"response":{"timestamp":"2026-06-17T04:10:43.849Z","pnl_estimate":{"percentage":null,"absolute_usd":null},"token_address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","entry_estimate":{"avg_price":null,"first_transfer_date":null},"wallet_address":"0xAbCdEf1234567890AbCdEf1234567890AbCdEf12","net_tokens_sent":"0.000000","response_time_ms":97,"current_price_usd":0.000007111,"current_value_usd":null,"transfers_analyzed":0,"net_tokens_received":"0.000000","current_balance_estimate":"0.000000","price_change_since_entry":null}},"exampleRequest":{"token_address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","wallet_address":"0xAbCdEf1234567890AbCdEf1234567890AbCdEf12"},"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lGGjJtWuC1rgS0mxQdnWl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a wallet's token position returning current balance, PnL estimate, and entry price approximation","exampleAgentPrompt":"What's the current position for wallet 0xAbC...123 on the WETH token — give me the balance, estimated PnL, and approximate entry price.","exampleUseCases":null,"resultDescription":"Returns the wallet's current token balance, an estimated profit-and-loss figure, and an approximated entry price for the specified token position, enabling assessment of unrealized gains or losses.","failureModes":["Invalid or unrecognized wallet address returns an error","Token address not found on the specified chain","Insufficient on-chain transaction history to compute entry price approximation","Chain not supported returns 400 or unsupported chain error","Payment of 0.25 USDC not completed returns 402 Payment Required","Rate limiting or service unavailability returns 503"],"whenToPreferThis":"Choose this endpoint when you need a quick, combined view of a wallet's token position including balance, estimated PnL, and entry price — especially in DeFi monitoring workflows where you need all three metrics in a single call rather than stitching together separate balance and transaction history queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:29.034Z","isFirstParty":false}