{"uid":"cap_8FV9qOpy7P1j7EaQscxsU","slug":"token-portfolio-risk-scanner-df24ad37","name":"Token Portfolio Risk Scanner","description":"Invoice-to-JSON, on-chain tools (transaction explainer + payment check, wallet profile, contract ABI, ERC-20 token risk), company contacts and web-to-RAG for AI agents. Pay per call with x402 (USDC on Base). No signup, no API key.","url":"https://freetier-agent-api.pages.dev/api/token-portfolio?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"],"type":"string"},"queryParams":{"type":"object","required":["addresses"],"properties":{"chain":{"enum":["base","ethereum"],"type":"string","description":"default base"},"addresses":{"type":"string","description":"comma-separated token addresses, max 20"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"tokens":[{"symbol":"DEGEN","riskLevel":"low","riskScore":16}],"summary":{"low":3,"high":0,"medium":0,"tokens":3,"unknown":0,"averageRiskScore":9}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p-p0FhbRAUCKfjy27Dh4M","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scans up to 20 ERC-20 token addresses in one call for risk levels, scores, flags, liquidity, and price on Base or Ethereum, returning a portfolio-level summary.","exampleAgentPrompt":"Can you run a risk scan on these 5 Base tokens for me: 0xAbc..., 0xDef..., 0x123..., 0x456..., 0x789...? I want to know which ones are high risk and why, including honeypot flags and liquidity info.","exampleUseCases":[{"title":"Pre-trade portfolio risk screening","prompt":"Before I ape into these tokens, can you check the risk scores and honeypot status for all 10 of them on Base? Here are the contract addresses: 0xAbc..., 0xDef..., 0x123..., 0x456..., 0x789..., 0xaaa..., 0xbbb..., 0xccc..., 0xddd..., 0xeee..."},{"title":"Wallet health check for existing holdings","prompt":"I want to audit the tokens currently in my Ethereum wallet. Can you run a risk scan on these 15 ERC-20 contract addresses and tell me which ones are flagged as high risk or have suspicious tax structures?"},{"title":"DeFi due diligence before investing","prompt":"I'm looking at adding DEGEN and a few other meme coins to my portfolio on Base — can you check all 8 of these contract addresses for rug pull flags, LP lock status, and liquidity, and give me a summary of which are the riskiest?"}],"resultDescription":"Returns a JSON object with a `tokens` array (each entry containing symbol, risk level, risk score, top flags with source field names, liquidity, and price) and a `summary` object (counts per risk level, average risk score, and list of riskiest tokens). Risk levels are low, medium, high, or unknown.","failureModes":["More than 20 addresses supplied — API rejects or truncates input","Invalid or non-ERC-20 contract address causes unknown risk level for that token","Token not found on DexScreener returns null liquidity/price data","Unsupported chain (not Base or Ethereum) causes validation error","GoPlus API rate limit or downtime results in missing contract flag data","Malformed comma-separated address string causes parsing failure"],"whenToPreferThis":"Use this endpoint when you need to assess risk across multiple ERC-20 tokens in a single call rather than checking them one by one. It is ideal for pre-trade due diligence, wallet audits, or portfolio monitoring on Base or Ethereum. It aggregates GoPlus Security contract analysis (honeypot simulation, taxes, holder concentration, LP lock) with DexScreener liquidity and price data, making it more comprehensive than a single-source token scanner. Prefer this over manual chain explorers when you need structured, agent-parseable risk output across a batch of addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:45:29.463Z","isFirstParty":false,"canonicalSlug":"token-portfolio-risk-scanner-df24ad37"}