{"uid":"cap__bbjBcw6fqpa7V_YfJQgL","slug":"defi-safety-oracle-token-holder-card-849b7751","name":"DeFi Safety Oracle – Token Holder Card","description":"The plain-language card for a token ($0.10): who holds the supply, who can pull the pool, who holds powers over the token, and the largest sensible position, in under 900 characters, as text plus a verdict (go, caution, no_go). Free quote first at /v1/holders/quote, then ?quote=<id>. Not financial advice.","url":"https://oracle.cyberwarex.com/v1/holders/card?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["quote"],"properties":{"quote":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"text":{"type":"string"},"verdict":{"type":"string"},"max_position_usd":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V6yCRvtC5dVVQkXnVdOxZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a plain-language card (~900 chars) revealing who holds a token's supply, who can pull the pool, and who controls token powers, plus a go/caution/no_go verdict and max safe position in USD","exampleAgentPrompt":"Can you pull the holder safety card for this token — I need to know who controls the supply, whether anyone can rug the pool, and what the biggest sensible position would be? I already have a quote ID: abc123.","exampleUseCases":[{"title":"Rug pull risk check before buying","prompt":"Before I ape into this Base token at 0x1234...abcd, can you get me the holder card so I can see if a whale or dev wallet controls the supply and whether the pool can be pulled? I have a quote ID: qid_789xyz."},{"title":"Max position sizing for a new token","prompt":"I'm thinking of taking a position in this token but I want to know the recommended maximum safe position size and whether the holder distribution looks healthy — can you get the DeFi safety card for quote ID qid_456def?"},{"title":"Quick pre-trade safety summary for a trading bot","prompt":"Run the holder card check on quote ID qid_101ghi and tell me the verdict — go, caution, or no_go — and give me the plain-English summary of who holds power over this token before I execute the trade."}],"resultDescription":"A plain-language text card under 900 characters summarizing: top holder concentration, who can drain the liquidity pool, which addresses hold admin/owner powers over the token contract, and the largest sensible position size in USD. Also returns a machine-readable verdict string (go, caution, or no_go) and max_position_usd as a number.","failureModes":["Invalid or expired quote ID returns an error — quotes must be fetched first from /v1/holders/quote","Token not indexed on supported chains (Base, Ethereum, BSC) returns no data","Payment not completed or quote not confirmed results in 402 Payment Required","Malformed query parameter (missing quote field) returns 400 Bad Request","Token with no liquidity or very low activity may return incomplete holder data"],"whenToPreferThis":"Choose this endpoint when you need a human-readable, narrative summary of token holder risk rather than raw on-chain data. It is ideal for agents that need to present a concise risk briefing to a user before a trade, combining holder concentration, pool control risk, and power holder analysis into a single card with an actionable verdict. Prefer this over the raw holder scan endpoint when the consumer is a human or a reasoning agent that needs a verdict, not a data analyst processing bulk structured data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:06.687Z","isFirstParty":false,"canonicalSlug":"defi-safety-oracle-token-holder-card-849b7751"}