{"openapi":"3.1.0","info":{"title":"SolMachina — machine-payable Solana intelligence","version":"0.1.9","description":"Paid data endpoints over x402 (HTTP 402 + exact USDC on Solana mainnet).","contact":{"name":"SolMachina","email":"contact.notamob@gmail.com","url":"https://api.solmachina.com"}},"servers":[{"url":"/"}],"paths":{"/v1/smri":{"get":{"operationId":"v1_smri","tags":["intelligence"],"summary":"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>.","description":"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 (10000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 SPL token mint to score, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"smri":{"type":["integer","null"],"minimum":0,"maximum":100},"smriBand":{"type":"string","enum":["unknown","low-risk","medium-risk","high-risk"]},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Fraction of intended components with available data; not a probability of safety."},"components":{"type":"object","properties":{"contract":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"weight":{"type":"number","minimum":0,"maximum":1},"note":{"type":"string"}}},"concentration":{"type":"object","properties":{"score":{"anyOf":[{"type":"integer","minimum":0,"maximum":100},{"const":"unknown"}]},"weight":{"type":"number","minimum":0,"maximum":1},"note":{"type":"string"}}}}},"riskBand":{"type":"string"}}},"example":{"mint":"DezX…B263","smri":82,"smriBand":"low-risk","confidence":1,"components":{"contract":{"score":100},"concentration":{"score":56}},"riskBand":"low"}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":10000,"asset":"USDC","decimals":6,"price":"$0.01","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/simulate":{"get":{"operationId":"v1_simulate","tags":["execution"],"summary":"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>.","description":"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 (10000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"tx","in":"query","required":true,"description":"Base64-encoded serialized Solana transaction to dry-run.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"willSucceed":{"type":"boolean"},"unitsConsumed":{"type":"integer"},"err":{},"accountsTouched":{"type":"integer"},"note":{"type":"string"}}},"example":{"willSucceed":true,"unitsConsumed":41200,"err":null,"accountsTouched":6,"note":"Dry-run via simulateTransaction. NOT a guarantee."}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":10000,"asset":"USDC","decimals":6,"price":"$0.01","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/decision":{"get":{"operationId":"v1_decision","tags":["intelligence"],"summary":"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).","description":"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 (50000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 SPL token mint to assess, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},{"name":"action","in":"query","required":false,"description":"Single nonblank context string; default assess. Does not execute an action.","schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"amountUsd","in":"query","required":false,"description":"Single finite non-negative decimal USD amount, context only; does not change the score. No exponent notation or repeated values.","schema":{"type":"string","pattern":"^(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)$"}},{"name":"minSmri","in":"query","required":false,"description":"Agent Financial Firewall — your policy: require SMRI >= this (0-100). Adds policy.verdict = ALLOW/DENY (fail-closed).","schema":{"type":"number","minimum":0,"maximum":100}},{"name":"maxConcentrationPct","in":"query","required":false,"description":"Firewall: DENY if top-10 holder concentration exceeds this %.","schema":{"type":"number","minimum":0,"maximum":100}},{"name":"minConfidence","in":"query","required":false,"description":"Firewall: DENY if data confidence is below this (0-1).","schema":{"type":"number","minimum":0,"maximum":1}},{"name":"denyMintAuthority","in":"query","required":false,"description":"Firewall: DENY if the mint authority is still set.","schema":{"type":"boolean"}},{"name":"denyFreezeAuthority","in":"query","required":false,"description":"Firewall: DENY if the freeze authority is still set.","schema":{"type":"boolean"}},{"name":"denyHighRiskBand","in":"query","required":false,"description":"Firewall: DENY if the token-risk band is 'high'.","schema":{"type":"boolean"}},{"name":"policy","in":"query","required":false,"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.","schema":{"type":"string","enum":["conservative","bluechip","anti-rug","degen"]}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["EXECUTE","REVIEW","REJECT"]},"smri":{"type":["integer","null"],"minimum":0,"maximum":100},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Fraction of intended components with available data; not a probability of safety."},"smriBand":{"type":"string","enum":["unknown","low-risk","medium-risk","high-risk"]},"riskBand":{"type":"string"},"components":{"type":"object","properties":{"contract":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"weight":{"type":"number","minimum":0,"maximum":1},"note":{"type":"string"}}},"concentration":{"type":"object","properties":{"score":{"anyOf":[{"type":"integer","minimum":0,"maximum":100},{"const":"unknown"}]},"weight":{"type":"number","minimum":0,"maximum":1},"note":{"type":"string"}}}}},"reason":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}},"example":{"decision":"REVIEW","smri":72,"confidence":1,"smriBand":"medium-risk","riskBand":"medium","components":{"contract":{"score":100,"weight":0.6},"concentration":{"score":44,"weight":0.4}},"reason":"SMRI in review range","warnings":["Top 10 token accounts hold 49% of circulating supply — moderately concentrated."]}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":50000,"asset":"USDC","decimals":6,"price":"$0.05","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/token-holders":{"get":{"operationId":"v1_token_holders","tags":["intelligence"],"summary":"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>.","description":"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 (5000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 SPL token mint address, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK). Major stablecoins like USDC have too many accounts to snapshot.","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"supply":{"type":"object","properties":{"uiAmount":{"type":"integer"},"decimals":{"type":"integer"}}},"concentration":{"type":"object","properties":{"top1Pct":{"type":"number"},"top10Pct":{"type":"number"},"band":{"type":"string"}}},"largestAccounts":{"type":"object","properties":{"returned":{"type":"integer"},"limit":{"type":"integer"}}},"buckets":{"type":"object","properties":{"gt5pct":{"type":"integer"},"from1to5pct":{"type":"integer"},"lt1pct":{"type":"integer"},"unknown":{"type":"integer"}}}}},"example":{"supply":{"uiAmount":1000000000,"decimals":5},"concentration":{"top1Pct":12.34,"top10Pct":41.2,"band":"moderate"},"largestAccounts":{"returned":20,"limit":20},"buckets":{"gt5pct":3,"from1to5pct":6,"lt1pct":11,"unknown":0}}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":5000,"asset":"USDC","decimals":6,"price":"$0.005","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/slippage-map":{"get":{"operationId":"v1_slippage_map","tags":["execution"],"summary":"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).","description":"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 (5000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"inputMint","in":"query","required":true,"description":"Base58 mint you are selling, e.g. So11111111111111111111111111111111111111112 (SOL).","schema":{"type":"string"}},{"name":"outputMint","in":"query","required":true,"description":"Base58 mint you are buying, e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC).","schema":{"type":"string"}},{"name":"amount","in":"query","required":true,"description":"Base units of inputMint for the 1x reference size (lamports for SOL, 1e6 per USDC).","schema":{"type":"string"}},{"name":"slippageBps","in":"query","required":false,"description":"Slippage tolerance in basis points for min-received, 0-5000 (default 50).","schema":{"type":"integer"}},{"name":"mults","in":"query","required":false,"description":"Optional comma-separated size multipliers of the base amount (default 0.1,1,10,100; up to 8).","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"pair":{"type":"object","properties":{"inputMint":{"type":"string"},"outputMint":{"type":"string"}}},"baseAmount":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"mult":{"type":"integer"},"sizeBaseUnits":{"type":"string"},"swapUsdValue":{"type":"integer"},"priceImpactPct":{"type":"number"},"band":{"type":"string"}}}},"depth":{"type":"object","properties":{"under1pct":{"type":"object","properties":{"maxUsd":{"type":"integer"}}},"under5pct":{"type":"object","properties":{"maxUsd":{"type":"integer"}}}}}}},"example":{"pair":{"inputMint":"So111…1112","outputMint":"EPjF…Dt1v"},"baseAmount":"1000000000","points":[{"mult":1,"sizeBaseUnits":"1000000000","swapUsdValue":1000,"priceImpactPct":0.12,"band":"low"},{"mult":10,"swapUsdValue":10000,"priceImpactPct":1.4,"band":"moderate"}],"depth":{"under1pct":{"maxUsd":1000},"under5pct":{"maxUsd":100000}}}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":5000,"asset":"USDC","decimals":6,"price":"$0.005","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/tipfloor":{"get":{"operationId":"v1_tipfloor","tags":["execution"],"summary":"Jito bundle tip-floor snapshot + rolling history (p50/p95/p99/EMA). Optional ?fresh=true bypasses the ~60s cache for a live snapshot.","description":"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 (1000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"fresh","in":"query","required":false,"description":"If 'true', bypass the ~60s cache and fetch a live tip-floor snapshot (otherwise a cached snapshot is served).","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"unit":{"type":"string"},"p50":{"type":"integer"},"p95":{"type":"integer"},"p99":{"type":"integer"},"ema":{"type":"integer"}}},"example":{"unit":"lamports","p50":12000,"p95":85000,"p99":250000,"ema":15400}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":1000,"asset":"USDC","decimals":6,"price":"$0.001","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/epoch":{"get":{"operationId":"v1_epoch","tags":["timing"],"summary":"Live epoch info + ETA to epoch end (dual measured slot-rates labeled). Optional ?rate= selects which measured rate drives the ETA.","description":"Live epoch info + ETA to epoch end (dual measured slot-rates labeled). Optional ?rate= selects which measured rate drives the ETA. Price: $0.001 (1000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"rate","in":"query","required":false,"description":"Which measured slot-rate to use for the ETA: 'primary', 'alt', or 'both' (default).","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"epoch":{"type":"integer"},"slotIndex":{"type":"integer"},"slotsInEpoch":{"type":"integer"},"etaSecondsToEnd":{"type":"integer"}}},"example":{"epoch":812,"slotIndex":210344,"slotsInEpoch":432000,"etaSecondsToEnd":84210}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":1000,"asset":"USDC","decimals":6,"price":"$0.001","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/kamino/markets":{"get":{"operationId":"v1_kamino_markets","tags":["defi"],"summary":"Kamino mainnet market list (trimmed JSON). Optional ?limit caps how many markets are returned.","description":"Kamino mainnet market list (trimmed JSON). Optional ?limit caps how many markets are returned. Price: $0.001 (1000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"limit","in":"query","required":false,"description":"Max markets to return, 1-100 (default 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"markets":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":"string"},"tvlUsd":{"type":"integer"}}}}}},"example":{"markets":[{"name":"Main Market","address":"7u3H...","tvlUsd":12345678}]}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":1000,"asset":"USDC","decimals":6,"price":"$0.001","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/sgp-checkpoint":{"get":{"operationId":"v1_sgp_checkpoint","tags":["timing"],"summary":"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.","description":"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 (5000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"n","in":"query","required":false,"description":"How many most-recent series points to include in `series.recent`, 1-200 (default 20).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"latest":{"type":"object","properties":{"epoch":{"type":"integer"},"slotIndex":{"type":"integer"},"slotsInEpoch":{"type":"integer"},"progressPct":{"type":"number"}}},"measured":{"type":"object","properties":{"slotMs":{"type":"number"},"baselineSpanHours":{"type":"number"},"etaEpochEndIso":{"type":"string"}}},"series":{"type":"object","properties":{"count":{"type":"integer"},"lastTransition":{"type":"object","properties":{"fromEpoch":{"type":"integer"},"toEpoch":{"type":"integer"}}}}}}},"example":{"latest":{"epoch":1023,"slotIndex":243839,"slotsInEpoch":432000,"progressPct":56.44},"measured":{"slotMs":351.2,"baselineSpanHours":148.2,"etaEpochEndIso":"2026-09-02T20:00:00.000Z"},"series":{"count":179,"lastTransition":{"fromEpoch":1022,"toEpoch":1023}}}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":5000,"asset":"USDC","decimals":6,"price":"$0.005","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/token-risk":{"get":{"operationId":"v1_token_risk","tags":["intelligence"],"summary":"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>.","description":"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 (28000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 SPL token mint address to scan, e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC).","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"riskAssessment":{"type":"object","properties":{"band":{"type":"string"},"summary":{"type":"string"}}},"mintAuthority":{"type":"object","properties":{"present":{"type":"boolean"}}},"freezeAuthority":{"type":"object","properties":{"present":{"type":"boolean"}}},"disclaimer":{"type":"string"}}},"example":{"riskAssessment":{"band":"high","summary":"2 high-risk signal(s) present out of 5 checks."},"mintAuthority":{"present":true},"freezeAuthority":{"present":true},"disclaimer":"Heuristic on-chain signals only. NOT financial advice."}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":28000,"asset":"USDC","decimals":6,"price":"$0.028","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/wallet-scan":{"get":{"operationId":"v1_wallet_scan","tags":["intelligence"],"summary":"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>.","description":"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 (20000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"address","in":"query","required":true,"description":"Base58 Solana wallet address to profile.","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"GThUX1Atko4tqhN2NaiTazWSeFWMuiUvfFnyJyUghFMJ"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"band":{"type":"string"},"summary":{"type":"string"}}},"solBalance":{"type":"number"},"activity":{"type":"object","properties":{"recentSignatures":{"type":"integer"}}},"tokens":{"type":"object","properties":{"splTokenAccounts":{"type":"integer"}}}}},"example":{"profile":{"band":"active","summary":"An active wallet with a normal on-chain footprint."},"solBalance":3.42,"activity":{"recentSignatures":214},"tokens":{"splTokenAccounts":18}}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":20000,"asset":"USDC","decimals":6,"price":"$0.02","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/token-intel":{"get":{"operationId":"v1_token_intel","tags":["intelligence"],"summary":"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>.","description":"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 (50000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 SPL token mint address to profile, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"digest":{"type":"object","properties":{"riskBand":{"type":"string"},"canStillMint":{"type":"boolean"},"canFreezeAccounts":{"type":"boolean"},"top10ConcentrationPct":{"type":"number"},"isToken2022":{"type":"boolean"}}},"disclaimer":{"type":"string"}}},"example":{"digest":{"riskBand":"low","canStillMint":false,"canFreezeAccounts":false,"top10ConcentrationPct":34.1,"isToken2022":false},"disclaimer":"Verdict-free. NOT financial advice."}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":50000,"asset":"USDC","decimals":6,"price":"$0.05","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/batch/token-risk":{"get":{"operationId":"v1_batch_token_risk","tags":["intelligence"],"summary":"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>.","description":"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 (100000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mints","in":"query","required":true,"description":"Comma-separated base58 SPL mint addresses, up to 10 (duplicates removed), e.g. mintA,mintB,mintC.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"requested":{"type":"integer"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"mint":{"type":"string"},"risk":{"type":"object","properties":{"disclaimer":{"type":"string"},"riskBand":{"type":"string"}}}}}}}},"example":{"requested":2,"count":2,"results":[{"mint":"EPjF…Dt1v","risk":{"disclaimer":"…","riskBand":"low"}},{"mint":"bad","error":"invalid_mint"}]}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":100000,"asset":"USDC","decimals":6,"price":"$0.10","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/priority-fee":{"get":{"operationId":"v1_priority_fee","tags":["execution"],"summary":"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.","description":"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 (2000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"accounts","in":"query","required":false,"description":"Optional comma-separated base58 addresses to narrow the fee sample to transactions that write-locked them (e.g. a hot AMM pool).","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"unit":{"type":"string"},"percentiles":{"type":"object","properties":{"p50":{"type":"integer"},"p75":{"type":"integer"},"p90":{"type":"integer"},"p99":{"type":"integer"}}},"suggestedBands":{"type":"object","properties":{"economy":{"type":"integer"},"normal":{"type":"integer"},"fast":{"type":"integer"},"aggressive":{"type":"integer"}}}}},"example":{"unit":"microLamportsPerComputeUnit","percentiles":{"p50":0,"p75":5000,"p90":20000,"p99":120000},"suggestedBands":{"economy":0,"normal":5000,"fast":20000,"aggressive":120000}}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":2000,"asset":"USDC","decimals":6,"price":"$0.002","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/dex-quote":{"get":{"operationId":"v1_dex_quote","tags":["execution"],"summary":"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).","description":"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 (3000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"inputMint","in":"query","required":true,"description":"Base58 mint you are selling, e.g. So11111111111111111111111111111111111111112 (SOL).","schema":{"type":"string"}},{"name":"outputMint","in":"query","required":true,"description":"Base58 mint you are buying, e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC).","schema":{"type":"string"}},{"name":"amount","in":"query","required":true,"description":"Amount of inputMint in its base units (lamports for SOL, 1e6 per USDC).","schema":{"type":"string"}},{"name":"slippageBps","in":"query","required":false,"description":"Slippage tolerance in basis points for min-received, 0-5000 (default 50 = 0.5%).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"output":{"type":"object","properties":{"amount":{"type":"string"},"minReceived":{"type":"string"},"swapUsdValue":{"type":"number"}}},"priceImpact":{"type":"object","properties":{"pct":{"type":"number"},"band":{"type":"string"}}},"route":{"type":"object","properties":{"hops":{"type":"integer"},"path":{"type":"array","items":{"type":"object","properties":{"amm":{"type":"string"}}}}}}}},"example":{"output":{"amount":"99201232","minReceived":"98705226","swapUsdValue":99.2},"priceImpact":{"pct":0.0046,"band":"minimal"},"route":{"hops":1,"path":[{"amm":"Meteora"}]}}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":3000,"asset":"USDC","decimals":6,"price":"$0.003","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/trending-tokens":{"get":{"operationId":"v1_trending_tokens","tags":["market"],"summary":"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).","description":"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 (5000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"limit","in":"query","required":false,"description":"How many trending pools to return, 1-20 (default 15).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"pools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"baseMint":{"type":"string"},"priceChangePct":{"type":"object","properties":{"h24":{"type":"number"}}},"volume24hUsd":{"type":"integer"},"liquidityUsd":{"type":"integer"}}}}}},"example":{"count":15,"pools":[{"name":"BONK / SOL","baseMint":"DezX…B263","priceChangePct":{"h24":12.3},"volume24hUsd":1234567,"liquidityUsd":987654}]}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":5000,"asset":"USDC","decimals":6,"price":"$0.005","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/new-pairs":{"get":{"operationId":"v1_new_pairs","tags":["market"],"summary":"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).","description":"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 (5000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"limit","in":"query","required":false,"description":"How many new pools to return, 1-20 (default 15).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"pools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"baseMint":{"type":"string"},"ageMinutes":{"type":"integer"},"liquidityUsd":{"type":"integer"},"volume24hUsd":{"type":"integer"}}}}}},"example":{"count":15,"pools":[{"name":"X / SOL","baseMint":"…","ageMinutes":3,"liquidityUsd":4200,"volume24hUsd":1500}]}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":5000,"asset":"USDC","decimals":6,"price":"$0.005","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/nft-collection":{"get":{"operationId":"v1_nft_collection","tags":["market"],"summary":"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>.","description":"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 (3000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"symbol","in":"query","required":true,"description":"Magic Eden collection symbol, e.g. mad_lads or okay_bears.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"floorPriceSol":{"type":"number"},"listedCount":{"type":"integer"},"avgPrice24hrSol":{"type":"number"},"volume7dSol":{"type":"number"}}},"example":{"symbol":"mad_lads","floorPriceSol":8.588,"listedCount":238,"avgPrice24hrSol":8.9,"volume7dSol":1234.5}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":3000,"asset":"USDC","decimals":6,"price":"$0.003","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/tx-inspect":{"get":{"operationId":"v1_tx_inspect","tags":["forensics"],"summary":"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>.","description":"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 (10000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"sig","in":"query","required":true,"description":"Base58 Solana transaction signature to decode.","schema":{"$ref":"#/components/schemas/TransactionSignature"},"example":"5wNsMQhQK1wNTzWRfrwLQqYEuJGcrzfh7qVYNThTDqNhJUnitQ1Y2AjqLFogXMq3r3oVwjYp5a8kFZBFTxYKzvJh"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"feeSol":{"type":"number"},"computeUnitsConsumed":{"type":"integer"},"programsInvoked":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}},"solBalanceChanges":{"type":"array","items":{}},"tokenBalanceChanges":{"type":"array","items":{}}}},"example":{"success":true,"feeSol":0.000028,"computeUnitsConsumed":41200,"programsInvoked":[{"name":"Jupiter Aggregator v6"}],"solBalanceChanges":[],"tokenBalanceChanges":[]}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":10000,"asset":"USDC","decimals":6,"price":"$0.01","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}},"/v1/pretrade":{"get":{"operationId":"v1_pretrade","tags":["intelligence"],"summary":"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>.","description":"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 (100000 atomic USDC units, 6 decimals). Without payment: HTTP 402 with x402 terms in the payment-required header (base64 JSON).","parameters":[{"name":"mint","in":"query","required":true,"description":"Base58 SPL token mint address to sweep, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).","schema":{"$ref":"#/components/schemas/SolanaPubkey"},"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}],"responses":{"200":{"description":"Paid success — decision-ready JSON (header PAYMENT-RESPONSE carries the settlement). The example below is representative, not live data.","content":{"application/json":{"schema":{"type":"object","properties":{"digest":{"type":"object","properties":{"riskBand":{"type":"string"}}},"largestHolder":{"type":"object","properties":{"band":{"type":"string"}}},"priorityFee":{"type":"object","properties":{"suggestedBands":{"type":"object","properties":{"normal":{"type":"integer"}}}}},"checklist":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string"},"observed":{"type":"boolean"}}}},"disclaimer":{"type":"string"}}},"example":{"digest":{"riskBand":"medium"},"largestHolder":{"band":"heavy"},"priorityFee":{"suggestedBands":{"normal":5000}},"checklist":[{"check":"mint authority renounced","observed":false}],"disclaimer":"Verdict-free (never buy/avoid). NOT financial advice."}}}},"400":{"description":"Invalid input (malformed base58 / missing param)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment Required - x402 challenge (header PAYMENT-REQUIRED, base64 JSON)","x-x402-price":{"amount":100000,"asset":"USDC","decimals":6,"price":"$0.10","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"HGLdAaCYcy98HsjLypcfaMjgQLujXEKfrbWc3MhrfNdG"}},"404":{"description":"Resource not found on-chain (unknown mint/sig)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Free-preview daily limit exhausted (storefront demo only) - includes Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Upstream RPC unavailable - fields that could not be computed stay 'unknown', never guessed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Kill-switch active (operator stop, audited event in WAL)"}}}}},"components":{"schemas":{"SolanaPubkey":{"type":"string","description":"Base58-encoded Solana public key (32 bytes decoded, 32-44 chars)","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","minLength":32,"maxLength":44},"TransactionSignature":{"type":"string","description":"Base58-encoded Solana transaction signature (64 bytes decoded)","pattern":"^[1-9A-HJ-NP-Za-km-z]{64,88}$","minLength":64,"maxLength":88},"ApiError":{"type":"object","properties":{"error":{"type":"string","description":"stable machine-readable error code (e.g. invalid_mint_address, upstream_unavailable)"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["error"]},"FreePreview":{"type":"object","properties":{"tier":{"type":"string","enum":["free"]},"preview":{"type":"boolean","enum":[true]},"upgrade":{"type":"string"}}}}},"x-x402":{"version":2,"facilitator":"/facilitator/supported","discovery":"/.well-known/x402","checkpoint":"/trust/checkpoint"}}