{"openapi":"3.1.0","info":{"title":"mlm.quest API","version":"1.0.0","description":"Solana launchpad with 3-level referral codes and a nightly pot."},"servers":[{"url":"https://api.mlm.quest"}],"paths":{"/health":{"get":{"summary":"ok, database, cluster, config address (null until created), worker heartbeat age, payouts live or dry","parameters":[],"responses":{"200":{"description":"ok"}}}},"/config":{"get":{"summary":"cluster, programs, our config, partner + pot wallets, fees (sniper decay, split, launch, graduation, graduated pool), Coach rules, $MLM","parameters":[],"responses":{"200":{"description":"ok"}}}},"/stats":{"get":{"summary":"coins live, members, buys today, volume 24h, pots today, paid out all time","parameters":[],"responses":{"200":{"description":"ok"}}}},"/coins":{"get":{"summary":"coins launched on mlm.quest. ?sort=mcap|new|volume|progress ?q= ?limit=","parameters":[{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/coins/{id}":{"get":{"summary":"one coin by mint or ticker: price, curve progress, pot today, top ten (live Coach), recent trades, holders","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/leaderboard":{"get":{"summary":"Coach board for a coin and day. ?coin=<mint|ticker> ?day=YYYY-MM-DD (default today, live). Each row: rank, code, score, level counts, estimated share, plain reasons","parameters":[{"name":"coin","in":"query","schema":{"type":"string"}},{"name":"day","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/recruiters":{"get":{"summary":"top recruiters by real buyers. ?days=30 ?limit=30","parameters":[{"name":"days","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/members/{id}":{"get":{"summary":"a member by wallet or code: code, sponsor, upline (3), downline counts, earnings, payouts, bags, tree, referral link","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/ticks":{"get":{"summary":"latest trades with the code they came through. ?limit= ?coin=","parameters":[{"name":"limit","in":"query","schema":{"type":"string"}},{"name":"coin","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/payouts":{"get":{"summary":"daily pot payouts and launch-fee refunds, each with its Solana tx. ?limit=","parameters":[{"name":"limit","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/contracts":{"get":{"summary":"every program and wallet the product uses, plus one row per coin pool (also MCP list_contracts)","parameters":[],"responses":{"200":{"description":"ok"}}}},"/pay-coins":{"get":{"summary":"tokens the site lets you pay with (live USD prices). SOL buys go straight to the curve; others swap to SOL through Jupiter first (mainnet)","parameters":[],"responses":{"200":{"description":"ok"}}}},"/holder/{wallet}":{"get":{"summary":"$MLM holder check: holds $27 or more (launch fee refunded in the daily run)","parameters":[{"name":"wallet","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/sign":{"get":{"summary":"the exact text to sign for a signed action. ?action=code.claim&wallet=&ts=&code=","parameters":[{"name":"action","in":"query","schema":{"type":"string"}},{"name":"wallet","in":"query","schema":{"type":"string"}},{"name":"ts","in":"query","schema":{"type":"string"}},{"name":"code","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/launch/tx":{"post":{"summary":"{wallet, name, symbol, description?, art?: \"p_candle\"|..., image?: data URL (png/jpg/webp <= 600 KB), firstBuySol?: 0 to 5, code?}. Returns one tx (base64, already signed by the new mint): sign and send it with your wallet. Costs 0.05 SOL launch fee + about 0.027 SOL rent + the first buy","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"ok"}}}},"/trade/tx":{"post":{"summary":"{wallet, coin: mint|ticker, side: \"buy\"|\"sell\", amount: SOL for buys / coins for sells (decimal string), code?, slippageBps? (default 300), payMint?}. Returns {txs: [base64...], quote}. The code rides in a memo; your first buy through a code sets your sponsor forever","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"ok"}}}},"/tx/confirm":{"post":{"summary":"{sig}: index a sent launch or trade right away (the worker also finds it within seconds)","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"ok"}}}},"/codes/claim":{"post":{"summary":"{wallet, ts, sig, code}: pick your own code once, before anyone joined under the old one. Message from GET /sign?action=code.claim","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"ok"}}}},"/events":{"get":{"summary":"SSE: launch, trade, graduated, payout","parameters":[],"responses":{"200":{"description":"ok"}}}},"/mcp":{"post":{"summary":"MCP (streamable HTTP, JSON). Tools: list_coins, get_coin, leaderboard, get_member, recent_trades, list_payouts, list_contracts, build_buy_tx, build_launch_tx","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"ok"}}}}}}