{"uid":"cap_5w195NeelutVmx__Ba_g1","slug":"freysa-intelligence-should-i-buy-token-analysis-bb68072c","name":"Freysa Intelligence – Should I Buy Token Analysis","description":"BUY/AVOID/CAUTION decision for any token. Combines honeypot check, contract risk, liquidity analysis, and holder concentration. Returns structured decision with confidence score and evidence. Deterministic pipeline.","url":"https://economic-agent-369.freysa.dev/api/should-i-buy","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","default":"base","description":"Blockchain"},"capital":{"type":"number","description":"Capital in USD"},"token_address":{"type":"string","description":"Token address"}}},"responseSchema":{"type":"object","example":{"should_i_buy":{"reasons":["Good liquidity","Contract verified"],"decision":"BUY","confidence":87,"risk_score":23}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q-gUJzmmPIlUcohq50XnG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a crypto token or asset and returns a buy/sell decision with confidence score, risk score, and reasoning based on on-chain security, liquidity, and contract verification data.","exampleAgentPrompt":"Should I buy this token? Run a security analysis on contract 0xAbC123... on Base — check its liquidity, whether the contract is verified, and give me a risk score and buy/sell recommendation.","exampleUseCases":[{"title":"Pre-trade token safety check","prompt":"Before my DeFi bot buys this new token at address 0x4e5b...d9 on Base, can you run a security check and tell me if it's safe — what's the risk score and should it actually buy?"},{"title":"Rug pull detection for new listings","prompt":"This token just launched and someone in my group is hyping it — can you analyze it for rug pull risk and contract red flags, and give me a confidence score on whether it's legit?"},{"title":"Autonomous agent buy gating","prompt":"My trading agent wants to purchase a position in this token — run a Freysa security check on it first and only proceed if the risk score is under 30 and the decision comes back as BUY."}],"resultDescription":"Returns a JSON object with a 'should_i_buy' field containing: a 'decision' (e.g. BUY or SELL/AVOID), a 'confidence' percentage (0-100), a 'risk_score' (0-100, lower is safer), and a 'reasons' array listing specific factors like liquidity quality, contract verification status, and on-chain red flags.","failureModes":["Invalid or missing token/contract input — returns error or empty schema response","Token not found on Base chain — insufficient on-chain data to assess","Payment failure via x402 — call not processed if 0.25 USDC payment not settled","Unverified or honeypot contract with insufficient data — low-confidence result","Rate limiting or service unavailability — no response or timeout"],"whenToPreferThis":"Choose this endpoint when an autonomous agent needs a fast, pay-per-call security gate before executing a token purchase on Base — especially when you need a structured BUY/AVOID decision with confidence and risk scores rather than raw chain data. Prefer this over general blockchain explorers when you need opinionated AI-driven recommendations with reasoning, and over manual audits when speed and automation matter. Ideal for DeFi trading bots, portfolio agents, and agentic wallets that need lightweight, inline security checks without building custom risk models.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:41:06.155Z","isFirstParty":false}