{"uid":"cap_IwJ3Yk5OL3Ylpp3FzsVAV","slug":"position-health-check-57b028c0","name":"Position Health Check","description":"The post-trade check everything else skips: given a token, your position size and (optionally) entry price, returns live price & P&L, whether the position can still be EXITED at that size, and the token's current rug score — combined into a healthy / watch / exit_now verdict with reasons. The risk that changes after you buy is exactly the risk holders miss.","url":"https://402.com.tr/api/x402/position-health","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["address"],"properties":{"size":{"type":"string","description":"Position size USD"},"address":{"type":"string","description":"Token contract address"},"entryPrice":{"type":"string","description":"Entry price USD (optional, enables P&L)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YBJC3h647vG8bimH3A5gZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a token address, position size, and optional entry price, returns live price, P&L, exit liquidity status, rug score, and a combined health verdict (healthy/watch/exit_now) for an open DeFi position.","exampleAgentPrompt":"Check the position health on token 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — I'm holding a $500 position and my entry price was $0.0012. Tell me if I can still exit at that size and what the current rug score looks like.","exampleUseCases":[{"title":"Pre-exit safety check for memecoin","prompt":"I'm sitting on a $2000 position in token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 that I bought at $0.0045 — can I still exit cleanly at that size, or is there a rug risk I should know about before I sell?"},{"title":"Automated portfolio health monitor","prompt":"Run a position health check on 0x4200000000000000000000000000000000000006 for a $750 position — no entry price needed, just tell me whether it's healthy, needs watching, or I should exit now."},{"title":"Post-pump rug risk evaluation","prompt":"A token I hold at 0x532f27101965dd16442E59d40670FaF5eBB142E9 just pumped hard — I'm in with $1200 at an entry of $0.0008. What's the rug score and can I still get out at that size? Give me the full verdict."}],"resultDescription":"Returns live token price, estimated P&L (if entry price provided), a boolean or status for whether the position can be exited at the given size, the token's current rug score, and an overall verdict of 'healthy', 'watch', or 'exit_now' with human-readable reasons explaining the assessment.","failureModes":["Invalid or non-existent token contract address returns an error or empty result","Token has no liquidity data, making exit assessment impossible","Very small or illiquid tokens may have unreliable rug scores","Missing required 'address' query parameter returns a 400-level error","Network congestion on Base may cause stale price data","Position size too small or too large for meaningful impact analysis"],"whenToPreferThis":"Use this endpoint when you need a post-purchase, real-time combined risk assessment for an existing open position — not just entry screening. It uniquely combines exit liquidity, live P&L, and rug scoring into a single actionable verdict, making it ideal for automated hold/exit decision loops. Prefer it over individual contract or holder analysis endpoints when speed and a unified go/no-go signal matter more than granular forensics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:24.025Z","isFirstParty":false}