# SolMachina — the trust & decision layer for Solana agents
> Before an autonomous agent executes, it asks SolMachina: risk + a decision (EXECUTE / REVIEW / REJECT) +
> an SMRI score (0-100) + evidence + a signed receipt — in one call (see /v1/decision). Paid per call over
> the x402 protocol (HTTP 402 + exact USDC), Solana + Base, no account. Trust-first: cites every source,
> reports "unknown" over guessing. Every paid answer is Ed25519-signed and logged in a public SHA-256 +
> Merkle ledger — don't trust the API, verify the answer.

## Endpoints (pay per call)
- GET /v1/batch/token-risk?mints=<string> — Batch heuristic risk scan for up to 10 SPL token mints in ONE call (mint + freeze authority, Token-2022 dangerous extensions, top-10 holder concentration per token). A portfolio/watchlist bundle over the token-risk engine; each mint returns its own result or an explicit error. Transparent, conservative ('unknown' over guessing). NOT financial advice. Requires ?mints=<comma-separated mint addresses>. Price: $0.10
- GET /v1/decision?mint=<string>?action=<opcional:string>?amountUsd=<opcional:string>?minSmri=<opcional:number>?maxConcentrationPct=<opcional:number>?minConfidence=<opcional:number>?denyMintAuthority=<opcional:boolean>?denyFreezeAuthority=<opcional:boolean>?denyHighRiskBand=<opcional:boolean>?policy=<opcional:string> — SolMachina Decision — the decision layer for autonomous agents: composes on-chain risk signals into ONE answer — EXECUTE / REVIEW / REJECT + SMRI (SolMachina Machine Risk Index 0-100) + confidence + full evidence. A transparent RISK GATE against stated thresholds — NOT financial advice, NOT a profit prediction; returns REVIEW/unknown instead of guessing. Requires ?mint=<token mint address>; optional ?action=, ?amountUsd=, and a named firewall ?policy= (conservative|bluechip|anti-rug|degen). Price: $0.05
- GET /v1/dex-quote?inputMint=<string>?outputMint=<string>?amount=<string>?slippageBps=<opcional:integer> — Live aggregated Solana swap quote from the Jupiter aggregator: best-route output, price impact with stated thresholds (minimal/low/moderate/high), min-received after slippage, transparent route path, USD value and a freshness slot. A quote, NOT an execution guarantee (impact/liquidity move block to block). NOT financial advice. Requires ?inputMint=&outputMint=&amount= (amount in the input token's base units). Price: $0.003
- GET /v1/epoch?rate=<opcional:string> — Live epoch info + ETA to epoch end (dual measured slot-rates labeled). Optional ?rate= selects which measured rate drives the ETA. Price: $0.001
- GET /v1/kamino/markets?limit=<opcional:integer> — Kamino mainnet market list (trimmed JSON). Optional ?limit caps how many markets are returned. Price: $0.001
- GET /v1/new-pairs?limit=<opcional:integer> — Newest Solana liquidity pools (GeckoTerminal): name, base mint, creation time, age in minutes, liquidity, 24h volume and price change. New pools are UNVETTED and structurally high-risk — pair each mint with /v1/token-risk before acting. Factual observation only, NOT a recommendation. NOT financial advice. Optional ?limit (1-20, default 15). Price: $0.005
- GET /v1/nft-collection?symbol=<string> — Solana NFT collection snapshot from Magic Eden: floor price (SOL + lamports), listed count, 24h average price and 7-day volume. The floor is the lowest CURRENT ask (not a guaranteed sale price) and moves continuously. Factual snapshot, NOT a recommendation. NOT financial advice. Requires ?symbol=<Magic Eden collection symbol>. Price: $0.003
- GET /v1/pretrade?mint=<string> — One-call PRE-TRADE SWEEP for a token: the full token-intel bundle (risk + executive digest + factual holder classification) PLUS a wallet-activity profile of the largest remaining holder PLUS observed priority-fee landing bands, distilled into a factual, threshold-stated checklist. Verdict-free (never 'buy'/'avoid'); partial sub-analyses are explicit errors, never silence. NOT financial advice. Requires ?mint=<token mint address>. Price: $0.10
- GET /v1/priority-fee?accounts=<opcional:string> — Solana priority-fee intelligence: the observed distribution (percentiles + suggested economy/normal/fast/aggressive bands) of prioritization fees actually paid in recent slots, in micro-lamports per compute unit. Optional ?accounts= narrows to txs write-locking specific markets. Observed history, NOT a prediction or inclusion guarantee. Price: $0.002
- GET /v1/sgp-checkpoint?n=<opcional:integer> — SolMachina's own Solana epoch-transition checkpoint series: the live epoch/slot reading (getEpochInfo via multi-RPC) measured against our accumulating on-disk series to yield a MEASURED slot-rate + ETA (not a model) and last epoch-transition detection. Optional ?n sets how many recent series points to return. Price: $0.005
- GET /v1/simulate?tx=<string> — Pre-flight transaction simulation for agents: dry-run a serialized Solana transaction (simulateTransaction) BEFORE executing — will it succeed, compute units consumed, program logs, and the error if any. NEVER signs or sends; simulation only, NOT a guarantee of the real on-chain outcome. NOT financial advice. Requires ?tx=<base64 serialized transaction>. Price: $0.01
- GET /v1/slippage-map?inputMint=<string>?outputMint=<string>?amount=<string>?slippageBps=<opcional:integer>?mults=<opcional:string> — Solana swap slippage / price-impact curve by trade SIZE: quotes the same pair at decade multiples of your base amount (via the Jupiter aggregator) and returns the impact per size plus a factual depth summary (largest tested size that stays under 1% / 5% impact). Execution intelligence beyond a single /v1/dex-quote. A quote, NOT an execution guarantee. NOT financial advice. Requires ?inputMint=&outputMint=&amount= (input base units). Price: $0.005
- GET /v1/smri?mint=<string> — SolMachina Machine Risk Index (SMRI) for an SPL token: a 0-100 safety score with transparent components (contract authorities, top-10 concentration), a risk band, and confidence (= data completeness). The cheap, high-frequency score behind /v1/decision — for agents that just want the number. Verdict-free, returns 'unknown' over guessing. NOT financial advice. Requires ?mint=<token mint address>. Price: $0.01
- GET /v1/tipfloor?fresh=<opcional:boolean> — Jito bundle tip-floor snapshot + rolling history (p50/p95/p99/EMA). Optional ?fresh=true bypasses the ~60s cache for a live snapshot. Price: $0.001
- GET /v1/token-holders?mint=<string> — Solana SPL token holder distribution / whale map: the largest token accounts (up to 20) each with its share of supply, plus top-1/5/10/20 concentration and simple buckets. More detailed than /v1/token-risk's single top-10 signal. Owners are NOT resolved and an account is not necessarily a distinct wallet; concentration is a structural signal, NOT a verdict. NOT financial advice. Requires ?mint=<token mint address>. Price: $0.005
- GET /v1/token-intel?mint=<string> — One-call Solana token intelligence bundle: the full token-risk analysis PLUS a decision-ready executive digest and factual top-holder classification (burn/system labels; unknowns left unresolved with owner exposed). Verdict-free, transparent, conservative ('unknown' over guessing). NOT financial advice. Requires ?mint=<token mint address>. Price: $0.05
- GET /v1/token-risk?mint=<string> — Heuristic Solana SPL token risk/signal scan: mint + freeze authority, Token-2022 dangerous extensions, top-10 holder concentration, plus best-effort holder-count/age context. Transparent methodology, conservative (reports 'unknown' over guessing). NOT financial advice. Requires ?mint=<token mint address>. Price: $0.028
- GET /v1/trending-tokens?limit=<opcional:integer> — Observed trending Solana tokens/pools (GeckoTerminal ranking of recent volume + activity): name, base mint, price + 1h/6h/24h change, 24h volume, liquidity, FDV, market cap, tx counts and pool age. Market-activity facts, NOT a recommendation, prediction or 'pump' signal — high volume does not imply safety. NOT financial advice. Optional ?limit (1-20, default 15). Price: $0.005
- GET /v1/tx-inspect?sig=<string> — Decode a Solana transaction into a structured summary: success/fee/compute-units, the programs it invoked (named for well-known ones), SOL balance deltas and SPL token balance deltas. Reports on-chain effects only, never intent. Requires ?sig=<transaction signature>. Price: $0.01
- GET /v1/wallet-scan?address=<string> — Solana wallet activity profile: age, transaction activity, SOL balance, SPL token holdings, and a factual footprint band (fresh/active/heavy/empty). Transparent, conservative ('unknown' over guessing), never a trust/scam judgement. NOT financial advice. Requires ?address=<wallet address>. Price: $0.02

## How to pay
Send GET to any endpoint: you receive HTTP 402 with header PAYMENT-REQUIRED (base64 JSON: accepts[] with
scheme=exact, amount in USDC units, payTo, network solana mainnet). Sign an x402 exact-USDC payment with any
x402 client library and retry with header PAYMENT-SIGNATURE or X-PAYMENT. Our facilitator verifies and settles on-chain.
Every paid response also carries an Ed25519-signed receipt (SolMachina Intelligence Receipt) in the
X-SolMachina-Receipt header: it binds the exact response (SHA-256) + resource + price + versions + ledger
head to our public identity. Verify it offline (npx solmachina-verify) or at /trust/verify (key at
/trust/pubkey); open spec at /trust/sir; transparency log + inclusion proofs at /trust/log + /trust/proof.

## Free routes
/health · /uptime · /.well-known/x402 (machine catalog) · /openapi.json · /facilitator/supported

## Trust
/uptime exposes WAL entry count + current chain head sha256. Tampering breaks the chain visibly.
Kill-switch: single file stops all paid traffic instantly (audited event in WAL).

Contact: SolMachina — contact.notamob@gmail.com. Not financial advice.