{"openapi":"3.0.3","info":{"title":"MOSN Solana Data API","version":"2.0.0","description":"Pay-per-call Solana token intelligence for agents and trading bots. Paid with USDC via x402 (Solana or Base)."},"servers":[{"url":"https://mosn-safety-api.onrender.com"}],"paths":{"/token-check":{"get":{"summary":"Use when about to buy, swap, or approve a Solana token and you must first know whether it is a rug, a honeypot, or cannot be sold. Solana token rug/safety check: mint & freeze authority, dangerous Token-2022 settings, real-wallet holder concentration (pools excluded), sell-route round-trip test, live buy/sell flow. Verdict SAFE/CAUTION/DANGER with reasons. First 5 checks per day are FREE (no payment, no signup).","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verdict SAFE/CAUTION/DANGER with reasons"},"402":{"description":"Payment required (x402)"}}}},"/new-pools":{"get":{"summary":"Use when you need Solana pools the moment they launch (PumpSwap/Raydium), for snipers and early-entry bots. Brand-new Solana pools (PumpSwap + Raydium CPMM) detected in real time from on-chain pool-creation logs, newest first, with live liquidity/volume/price change where DEX data exists. Optional ?minutes=1-120 (default 15).","parameters":[{"name":"minutes","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":120}}],"responses":{"200":{"description":"List of new pools"},"402":{"description":"Payment required (x402)"}}}},"/alpha":{"get":{"summary":"Use when you want a ready short-list of brand-new Solana tokens that already passed safety and flow screening, instead of scanning raw launches yourself. Fresh Solana alpha: up to 10 brand-new tokens MOSN screened in the last 5-120 minutes (default 30) that PASSED its rug/scam check, real-wallet holder check and buy/sell-flow filters — with MOSN AI verdict, confidence and reason, plus live price/liquidity/flow now.","parameters":[{"name":"minutes","in":"query","required":false,"schema":{"type":"integer","minimum":5,"maximum":120}}],"responses":{"200":{"description":"Screened fresh tokens"},"402":{"description":"Payment required (x402)"}}}},"/dataset":{"get":{"summary":"Use when training or backtesting a memecoin model and you need labeled new-token data with real forward price outcomes. Labeled Solana new-token dataset: every fresh token MOSN screened in the last 1-72 hours (default 24) — liquidity, volume, flow, holder concentration, age, socials, AI verdict — joined with its price change 5/10/15 minutes later. Up to 2000 rows of JSON. For training and backtesting memecoin models.","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":72}}],"responses":{"200":{"description":"Labeled rows"},"402":{"description":"Payment required (x402)"}}}},"/safe-swap":{"get":{"summary":"FREE to call. Runs MOSN's full safety check, refuses buys into DANGER tokens, then returns an unsigned Jupiter swap transaction for your wallet (MOSN takes a 0.3% platform fee in SOL).","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string"}},{"name":"side","in":"query","required":false,"schema":{"type":"string"}},{"name":"wallet","in":"query","required":true,"schema":{"type":"string"}},{"name":"amountSol","in":"query","required":false,"schema":{"type":"string"}},{"name":"amountRaw","in":"query","required":false,"schema":{"type":"string"}},{"name":"slippageBps","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Unsigned swap transaction + safety verdict"},"403":{"description":"Refused: DANGER token"}}}},"/holders":{"get":{"summary":"Use when you need to know whether a Solana token is whale- or insider-concentrated, counting real wallets only (pools excluded). Solana token holder concentration from REAL wallets only (liquidity pools and program accounts excluded): top wallet %, top-10 %, whale/insider flag.","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Holder concentration"},"402":{"description":"Payment required (x402)"}}}}}}