{"openapi":"3.1.0","info":{"title":"Solana DeFi Intelligence","version":"0.1.0","description":"Paid x402 API for Solana DeFi risk intelligence: rug/honeypot scan, wash-trade detection, real executable slippage and risk-adjusted pool yield. Pays on Base + Solana.","contact":{"email":"contato@thomenz.me"}},"servers":[{"url":"https://soldefi.thomenz.me"}],"tags":[{"name":"solana"},{"name":"defi"},{"name":"rug-check"},{"name":"honeypot"},{"name":"token-safety"},{"name":"liquidity-pool"},{"name":"wash-trading"},{"name":"slippage"},{"name":"yield"},{"name":"mev"},{"name":"raydium"},{"name":"meteora"}],"paths":{"/health":{"get":{"summary":"Health check (free)","security":[],"responses":{"200":{"description":"OK"}}}},"/v1/solana/validate/{mint}":{"get":{"summary":"Validate a Solana mint address format (free lure)","security":[],"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Valid"},"422":{"description":"Invalid"}}}},"/v1/solana/honeypot/{mint}":{"get":{"summary":"Rug & honeypot scan for a Solana token","description":"Rug & honeypot scan for any Solana SPL token by mint. On-chain: mint/freeze authority renounced?, Token-2022 transfer tax, top-holder concentration, plus a live buy->sell round trip via Jupiter proving the token is actually sellable (not a honeypot). Returns a 0-100 risk score, machine flags and an agent-readable verdict (AVOID/CAUTION/SAFE). For snipers, wallets and trading agents vetting a token before buying.","parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":0.02},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"mint":"9xYzExampleHoneypotMint1111111111111111111","network":"solana","checkedAt":"2026-07-05T12:00:00.000Z","token":{"program":"spl-token","decimals":6,"supply":"1000000000000000"},"authorities":{"mintAuthorityActive":false,"freezeAuthorityActive":true},"transferFeeBps":null,"holders":{"top1Pct":61.2,"top10Pct":88.4,"sampled":20},"tradeability":{"canBuy":true,"canSell":false,"sellPriceImpactPct":null,"recoveredPct":null,"liquidityDepthUsd":0},"riskScore":100,"riskLevel":"critical","flags":["cannot_sell","freeze_authority_active","concentration_extreme"],"verdict":"AVOID — cannot sell — honeypot, freeze authority active (can block sells), top-10 hold 88%","notes":[]}}}},"402":{"description":"Payment Required (x402 challenge)"},"422":{"description":"Invalid input (settlement auto-canceled; not charged)"},"503":{"description":"Upstream data source unavailable (not charged)"}}}},"/v1/solana/pool-intel":{"post":{"summary":"Deep per-pool + token analysis for a Solana token","description":"Deep liquidity-pool analysis for a Solana token across Raydium, Orca, Meteora, pumpswap. Per pool: real fee APR (volume x fee / TVL), wash-trade risk (turnover + executable-depth cross-check), age and TVL. Plus a token rug/honeypot verdict and a real Jupiter slippage ladder ($100/$1k/$10k) for true liquidity depth. Recommends the best risk-adjusted pool. For LP, yield and arbitrage agents.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mint":{"type":"string","description":"Solana SPL token mint to analyze."},"tradeSizesUsd":{"type":"array","items":{"type":"number","minimum":1},"description":"Optional USD trade sizes for the slippage ladder (default [100,1000,10000])."}},"required":["mint"],"additionalProperties":false}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":0.04},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"mint":"So11111111111111111111111111111111111111112","network":"solana","checkedAt":"2026-07-05T12:00:00.000Z","token":{"riskScore":4,"riskLevel":"low","verdict":"LOOKS SAFE — authorities renounced, sells cleanly, top-10 hold 31%","authorities":{"mintAuthorityActive":false,"freezeAuthorityActive":false},"tradeability":{"canBuy":true,"canSell":true,"sellPriceImpactPct":0.4,"recoveredPct":99.1,"liquidityDepthUsd":10000},"flags":[]},"slippageLadder":[{"sizeUsd":100,"ok":true,"priceImpactPct":0.01},{"sizeUsd":1000,"ok":true,"priceImpactPct":0.08},{"sizeUsd":10000,"ok":true,"priceImpactPct":0.62}],"pools":[{"poolAddress":"PoolAddr1111111111111111111111111111111111","dex":"raydium","name":"SOL / USDC","ageHours":8600,"tvlUsd":12400000,"volume24hUsd":41000000,"priceChange24hPct":1.2,"feeTierPct":0.25,"realFeeAprPct":30.2,"washTradingRisk":"low","turnover":3.3,"washReasons":["volume consistent with TVL"],"verdict":"real fee APR ~30.2% on $12400000 TVL"}],"bestPool":{"poolAddress":"PoolAddr1111111111111111111111111111111111","dex":"raydium","name":"SOL / USDC","ageHours":8600,"tvlUsd":12400000,"volume24hUsd":41000000,"priceChange24hPct":1.2,"feeTierPct":0.25,"realFeeAprPct":30.2,"washTradingRisk":"low","turnover":3.3,"washReasons":["volume consistent with TVL"],"verdict":"real fee APR ~30.2% on $12400000 TVL"},"notes":[]}}}},"402":{"description":"Payment Required (x402 challenge)"},"422":{"description":"Invalid input (settlement auto-canceled; not charged)"},"503":{"description":"Upstream data source unavailable (not charged)"}}}},"/v1/solana/pools/top":{"post":{"summary":"Curated 'real best' Solana pools (wash-trade filtered)","description":"The real best Solana DEX pools. Same top-pools feed a free API returns, but wash-traded and fake-volume pools are filtered out and the rest ranked by risk-adjusted fee yield (Raydium/Orca/Meteora). Returns clean, decision-ready pools plus an `excluded` list showing exactly which pools were dropped and why. For liquidity, yield and MEV agents that can't trust raw volume numbers.","requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Max pools to return (default 15)."},"minTvlUsd":{"type":"number","minimum":0,"description":"Minimum pool TVL in USD (default 10000)."}},"additionalProperties":false}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":0.05},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"network":"solana","checkedAt":"2026-07-05T12:00:00.000Z","limit":15,"minTvlUsd":10000,"pools":[{"poolAddress":"PoolAddr1111111111111111111111111111111111","dex":"raydium","name":"SOL / USDC","ageHours":8600,"tvlUsd":12400000,"volume24hUsd":41000000,"priceChange24hPct":1.2,"feeTierPct":0.25,"realFeeAprPct":30.2,"washTradingRisk":"low","turnover":3.3,"washReasons":["volume consistent with TVL"],"verdict":"real fee APR ~30.2% on $12400000 TVL","riskAdjustedScore":37.3}],"excluded":[{"poolAddress":"FakePool22222222222222222222222222222222222","name":"VAR / SOL","dex":"pumpswap","reason":"wash_trading: TVL $0 cannot support $126989379 volume"}],"excludedCount":1,"notes":["Pools flagged as wash-traded or below the TVL floor are excluded (see `excluded`)."]}}}},"402":{"description":"Payment Required (x402 challenge)"},"422":{"description":"Invalid input (settlement auto-canceled; not charged)"},"503":{"description":"Upstream data source unavailable (not charged)"}}}}}}