{"uid":"cap_2HXVpm_WlyBvd-Zy9Tv-q","slug":"shield-vainplex-dev-8a2c82bc","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":"0.00","reviews":0,"stars":null,"state":"unrated"},"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_Rd2uOloz86pZAQqaGLgsk","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 security blacklists and returns risk score, TOR exit node status, and reverse DNS","exampleAgentPrompt":"Can you check if the IP address 203.0.113.45 is blacklisted or has any security risks — I want to know its risk score, whether it's a TOR exit node, and which spam blacklists it appears on?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the queried IP, an array of blacklist check results (name, listed status, and optional DNSBL response), a risk_level string (e.g. 'medium'), a numeric risk_score, a boolean is_tor_exit flag, and the reverse DNS hostname.","failureModes":["Invalid or malformed IPv4 address returns an error response","Private or reserved IP ranges may not return meaningful blacklist data","Payment failure or insufficient USDC balance prevents the call from completing","Rate limiting may occur under high request volume","Blacklist data may be slightly stale depending on upstream provider refresh cycles"],"whenToPreferThis":"Use this endpoint when you need to quickly assess whether a specific IPv4 address poses a security threat, is listed on major spam/abuse blacklists (Spamhaus ZEN, SpamCop, SORBS, Barracuda), or is operating as a TOR exit node. Prefer this focused IP check over the full security scan endpoint when you only need IP-specific intelligence and want to minimize cost and latency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:32.053Z","isFirstParty":false}