{"uid":"cap_FJAnraSVXms-x9ewmjdct","slug":"solmachina-token-risk-decision-api-9a3ef40c","name":"SolMachina Token Risk Decision API","description":"Before an AI agent executes on Solana, it asks SolMachina: risk + a decision (EXECUTE/REVIEW/REJECT) + an SMRI score + a signed receipt, paid per call over x402 in USDC. Trust-first — cites every source, says 'unknown' over guessing. No account, no API key.","url":"https://api.solmachina.com/v1/decision","method":"GET","headers":{},"bodySchema":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","description":"Base58 SPL token mint to assess, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK)."},"action":{"type":"string","description":"Single nonblank context string; default assess. Does not execute an action."},"policy":{"enum":["conservative","bluechip","anti-rug","degen"],"type":"string","description":"Named firewall preset: conservative | bluechip | anti-rug | degen — expands to a full ALLOW/DENY policy (the individual params above override preset values). The response echoes policyTemplate."},"minSmri":{"type":"number","description":"Agent Financial Firewall — your policy: require SMRI >= this (0-100). Adds policy.verdict = ALLOW/DENY (fail-closed)."},"amountUsd":{"type":"string","description":"Single finite non-negative decimal USD amount, context only; does not change the score. No exponent notation or repeated values."},"minConfidence":{"type":"number","description":"Firewall: DENY if data confidence is below this (0-1)."},"denyHighRiskBand":{"type":"boolean","description":"Firewall: DENY if the token-risk band is 'high'."},"denyMintAuthority":{"type":"boolean","description":"Firewall: DENY if the mint authority is still set."},"denyFreezeAuthority":{"type":"boolean","description":"Firewall: DENY if the freeze authority is still set."},"maxConcentrationPct":{"type":"number","description":"Firewall: DENY if top-10 holder concentration exceeds this %."}}},"responseSchema":{"type":"object","properties":{"smri":{"type":["integer","null"],"maximum":100,"minimum":0},"reason":{"type":"string"},"decision":{"enum":["EXECUTE","REVIEW","REJECT"],"type":"string"},"riskBand":{"type":"string"},"smriBand":{"enum":["unknown","low-risk","medium-risk","high-risk"],"type":"string"},"warnings":{"type":"array","items":{"type":"string"}},"components":{"type":"object","properties":{"contract":{"type":"object","properties":{"note":{"type":"string"},"score":{"type":"integer","maximum":100,"minimum":0},"weight":{"type":"number","maximum":1,"minimum":0}}},"concentration":{"type":"object","properties":{"note":{"type":"string"},"score":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"const":"unknown"}]},"weight":{"type":"number","maximum":1,"minimum":0}}}}},"confidence":{"type":"number","maximum":1,"minimum":0,"description":"Fraction of intended components with available data; not a probability of safety."}}},"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_mgKs0Av5Yw_jX9LDDN_cE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Assesses a Solana SPL token's risk and returns an SMRI score, EXECUTE/REVIEW/REJECT decision, risk band, warnings, and a signed receipt — paid per call in USDC via x402.","exampleAgentPrompt":"Before you swap any USDC into BONK (mint: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263), check SolMachina first — I want an EXECUTE/REVIEW/REJECT decision and I need the SMRI score to be at least 60; deny it if the risk band is high or if mint authority is still set.","exampleUseCases":[{"title":"Pre-swap safety check for meme coin","prompt":"Before you buy any BONK for me, run it through SolMachina with a minimum SMRI of 60 and deny it if the freeze authority is still set or if top-10 holder concentration is above 40% — show me the decision and any warnings."},{"title":"Agent financial firewall for DeFi bot","prompt":"Set up a rule so that before my trading agent executes any Solana token swap over $500, it checks SolMachina and only proceeds if the SMRI is at least 70 and the confidence score is above 0.8."},{"title":"Due diligence on new SPL token listing","prompt":"We're about to list a new SPL token with mint address So11111111111111111111111111111111111111112 on our platform — can you assess it with SolMachina and tell me the risk band, SMRI score, and whether mint authority is still active?"}],"resultDescription":"Returns an SMRI integer score (0-100), a decision string (EXECUTE, REVIEW, or REJECT), a risk band, an SMRI band, a confidence integer, a human-readable reason, an array of warnings, component scores (contract and concentration each with score and weight), and optionally a policy verdict (ALLOW/DENY) if firewall parameters were supplied. A signed receipt is also returned for audit purposes.","failureModes":["Invalid or malformed Base58 mint address — endpoint returns an error or unknown token response","Token not found on-chain — low confidence score returned, decision likely REVIEW","Payment not received via x402 — request rejected before assessment","minSmri or minConfidence thresholds misconfigured — policy.verdict may incorrectly DENY valid tokens","Network or data-source unavailability — confidence score drops, sources cited as unknown"],"whenToPreferThis":"Use SolMachina when an AI agent needs a structured, auditable, policy-enforceable go/no-go decision before executing a Solana token action. It is especially valuable when you need composable firewall parameters (SMRI floor, freeze/mint authority checks, concentration limits) rather than raw on-chain data alone. Prefer it over generic token data APIs when you need a signed decision receipt, when operating in an autonomous agent pipeline where fail-closed safety is required, or when accountability and source citations matter. It is purpose-built for Solana agents and requires no API key — payment is per-call via x402 in USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:31:23.428Z","isFirstParty":false}