{"uid":"cap_6Kv3zg2WF59KRFUnTC-T6","slug":"shield-vainplex-dev-c9245b28","name":"ShieldAPI IP Reputation Check","description":"ShieldAPI - x402 security preflight before agents connect to IP infrastructure","url":"https://shield.vainplex.dev/api/cdp/check/ip","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":["ip"],"properties":{"ip":{"type":"string","description":"IPv4 address to check"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ip":"8.8.8.8"}}},"response":{"ip":"8.8.8.8","blacklists":[{"name":"Spamhaus ZEN","listed":true,"response":"127.255.255.254"},{"name":"SpamCop","listed":false},{"name":"SORBS","listed":false},{"name":"Barracuda","listed":false}],"risk_level":"medium","risk_score":20,"is_tor_exit":false,"reverse_dns":"dns.google"}},"exampleRequest":{"ip":"8.8.8.8"},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WVjXLiRe19KLzNXR2iyid","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks an IPv4 address against multiple DNS blocklists and returns risk score, TOR exit node status, and reverse DNS information","exampleAgentPrompt":"Can you check if the IP address 203.0.113.42 is blacklisted or flagged as malicious — I want to know its risk score and whether it's a TOR exit node before I allow it through.","exampleUseCases":null,"resultDescription":"Returns the queried IP with an array of blocklist results (including Spamhaus ZEN, SpamCop, SORBS, Barracuda with listed status and DNS response), an overall risk_level (e.g. 'medium'), a numeric risk_score, a boolean is_tor_exit flag, and the reverse_dns hostname.","failureModes":["Invalid or non-IPv4 address format returns an error","Private or reserved IP ranges may return incomplete results","Blocklist services may be temporarily unavailable causing partial results","Payment failure (402) if USDC balance is insufficient","Rate limiting if too many requests are made in a short window"],"whenToPreferThis":"Use this endpoint when you need to quickly assess whether a specific IPv4 address poses a security threat, has been flagged for spam or abuse, or is operating as a TOR exit node. Ideal for pre-authorization checks on incoming connections, validating user signup IPs, or enriching security logs with reputation data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-28T20:35:11.700Z","lastSuccessfullyRanAt":"2026-05-28T20:35:11.700Z","lastHealthCheckAt":"2026-09-15T12:45:56.439Z","isFirstParty":false}