koyn docs

What this is

koyn is a Solana desk. The board, swaps, limits, DCA, copy, the desk agent, and SOL/ETH/BTC perps settle from the connected wallet. Jupiter routes them. Non-custodial: the signer stays in the browser.

There is no KOYN token. Do not invent a contract address, team, launch date, quote ticker, fee percentage, or APY for one.

Canonical site: https://www.levercoin.lol

The family

  • koyn (this site) — the desk. Board, callouts, copy, the desk agent, perps, portfolio.
  • labs (https://labs.koyn.trade) — the MCP launchpad. Agents launch on pump.fun or StonkFun, trade the coin, and draft an X post. Every labs launch lists on this desk.

Desk

Organic score ranks the board. Jupiter reports it from 0 to 100 with a label: high, medium, or low. A low label is bot-heavy and ranks lower. KOYN does not invent a second score.

A momentum ring on the logo follows 24-hour volume: bronze under $10,000, silver from $10,000, gold from $100,000, and diamond from $1,000,000. A print in the last minute sweeps the ring in 2.2 seconds, a print in the last hour in 6 seconds, otherwise 10 seconds.

Market buy and sell settle in the wallet. Limit orders cover take profit, stop loss, buy the dip, buy the pump, one-cancels-other, and a limit buy that then sets an OCO. DCA buys on an interval of 15 minutes, 1 hour, 4 hours, or 1 day, for 4, 8, or 24 rounds. Limit and DCA deposit into a Jupiter vault until they fill. Cancel returns what is left.

On a coin page the left column has Wallets, Perps, Tokens, and Watchlist. Watchlist is the list saved in this browser. The right column has Trade, Pending, and Liquidity. Trade is the ticket. Pending lists open limit and DCA orders for this coin. Cancel returns what is left. Reclaim closes empty token accounts and returns the rent to the connected wallet. Portfolio has the same reclaim.

  • /tokens — three columns: New, Trending or Smart Money, and Migrated. Each column has its own search. Sort is volume, top, or liquidity. Curve is all, on curve, or perps. Pair filters include xStocks.
  • Venues on the board: StonkFun, pump.fun, Jupiter, and tokenized stocks.
  • Callouts — GMGN calls. The cards sit under the header. Signed in, the same coins also run along the footer. A call is good only with a like, a verified badge, or a KOL flag, mint and freeze authorities disabled, the coin not flagged, and any organic score at least 50 or labeled high or medium.
  • Copy — choose a wallet in the leaders column on a coin page. POST /api/trade/auto follows that wallet's token swaps after the signer is armed. Caps are 1 SOL per trade and 5 SOL for the session. Arming keeps running after the tab closes. Disarm stops it.
  • Perps — SOL, ETH, and BTC, routed by Jupiter, 1.1x–50x.
  • The same desk opens in the Telegram Mini App and the Discord Activity.

Agents

A face sits on each coin. Click it to ask the agent to look. Asleep means it is waiting. A signal means you place the trade. Holding means the agent has the pair on your wallet. Putting the face to sleep hands the pair back. It does not sell.

Allow agent to sign uses your Privy wallet. With it on, a wake can arm the pair and the agent places the Jupiter orders. With it off, the same wake is only a signal. An external wallet still signs your own market, limit, and DCA tickets. The agent does not sign those.

The book at /trade/agent lists every pair it holds: the note it wrote, entry, size, stop, target, and cycles. Open a coin from the book to see the same face beside the ticket.

An assistant can also connect at https://koyn.trade/mcp. Reads are free after OAuth. A swap quotes first. If Allow agent to sign is on, it can confirm in the same turn. Otherwise you open the verify link. Only a confirm result of filled with a txHash is a fill. The labs launcher at https://labs.koyn.trade/mcp is a separate agent. It launches tokens. It does not run the desk book.

  • Bronze, silver, gold, and diamond faces follow the same 24-hour volume metals as the momentum ring.
  • On a coin you already hold, the face can be asked to manage that bag. Signing off, you still place the trade.
  • Telegram: message the bot in private and send /alerts on. It DMs when the agent enters, adds, takes profit, or stops out. /alerts off stops them.
  • /mcp/start — connect the trade agent. Select the Privy wallet if you want it to sign.

Liquidity

The Liquidity tab on a coin puts that coin into its graduated pool and takes both tokens back when you stop it. A pump.fun coin goes to its PumpSwap pool. A StonkFun coin goes to its Raydium pool. Fees from trades stay in the pool until you stop. There is no price band, and the agent does not move a range.

The agent signs the Privy wallet. A buy from another wallet stays in that wallet. The tab names the wallet that holds the tokens and shows the Privy address. Send both tokens there, then press manage.

A pool takes two tokens in its ratio. When the other side is SOL, the agent swaps part of the coin into SOL so the deposit matches, then puts both in. When the other side is another token, including a stock such as xTSLA, hold both the coin and that token in the Privy wallet before you press manage. The agent deposits those two balances in the pool's ratio.

  • Open the coin. Liquidity is the right-hand tab after Pending.
  • The coin has to have graduated. On the bonding curve the tab says so and will not start.
  • Choose 25%, 50%, or 100%. Both tokens show together. 100% uses the most the wallet can match on both sides, and does not go past either balance. The face orbits the coin while the tokens are in the pool.
  • For a stock pair, the Privy wallet needs the coin and the stock, such as xTSLA, before manage. The tab sizes the deposit to whichever side you have less of.
  • Stop sends both tokens back to the Privy wallet. The fees come back with them.

Labs

labs (https://labs.koyn.trade/mcp) launches a token and can trade it. The wallet signs every transaction. labs does not take a wallet private key, and it does not charge a launch fee or a subscription.

A launch pairs against an xStock the wallet already holds. On pump.fun the quote also has to be one pump_pairs returns. Holder fee distribution has to be on: StonkFun reward mode, or pump.fun holder rewards. The launch is refused when either check fails. Up to three extra wallets the creator controls can buy in the same bundle.

  • launch_token, launch_status, token_info, wallet_balance, pump_pairs, stonks_pairs.
  • trade_swap and trade_order — market, limit, stop, take-profit/stop, or DCA of a pump.fun or StonkFun mint against SOL. Each returns a signing link. Routing is Jupiter.
  • perp_markets, perp_positions, perp_open, perp_close, perp_exit — SOL, ETH, and BTC perps.
  • start_maker, maker_status, stop_maker — a disclosed two-sided quoter on one mint from one wallet.
  • X — each person connects their own account at /x and gets a personal key, shown once. x_prepare_post does not post. x_publish_post publishes that exact draft after the user confirms it. Likes need a fresh connect with like.write.

Pages

The board, coin, agent, perps, and portfolio pages open after a wallet is connected.

  • / — the desk. Organic ranking, the momentum ring, and how to connect.
  • /tokens — the trenches. New, trending or smart money, and migrated, plus StonkFun, pump.fun, Jupiter, and tokenized stocks.
  • /meme/[mint] — one coin: leaders, chart, trades, and the ticket. The agent face sits on the coin. Wallets, this week's perps PnL, called tokens, and the watchlist sit in the left column. Copy fills the sniper there. The right column switches between the ticket, pending orders, and the liquidity agent. Pending lists open limit and DCA orders for this coin, and Cancel returns what is left. The liquidity agent deposits a graduated pump.fun coin into PumpSwap, or a graduated StonkFun coin into its Raydium pool, and withdraws both tokens when you stop it. It signs the Privy wallet. Its face orbits the coin while the tokens are in the pool. Reclaim is on that strip when a wallet is connected.
  • /trade/agent — pairs the desk agent holds for this wallet.
  • /trade/watchlist — tokens saved in this browser. The same list opens from the left column on a coin page. It is not stored on the server.
  • /trade/perps — SOL, ETH, BTC perpetuals.
  • /trade/portfolio — holdings in the connected wallet, priced by Jupiter, plus reclaim.
  • /mcp/start — connect an assistant to the trade agent.
  • /docs — this page. /llms.txt is the short index. /llms-full.txt is the full text.

Read

These GET routes return market data. They do not move funds. /api/trade answers only after a wallet is connected.

Agents connect at https://koyn.trade/mcp. Reads are free after OAuth. Scopes are read and trade. The labs launcher is a separate connector at https://labs.koyn.trade/mcp.

  • GET /api/trade/board — current board.
  • GET /api/trade/trenches — the New, Trending, and Migrated columns.
  • GET /api/trade/leaders — source=perps (default) and asset=SOL|ETH|BTC is this week's Jupiter perps PnL. limit is 1–25.
  • GET /api/trade/watchlist — prices for up to 100 comma-separated mints. The watchlist itself stays in the browser.
  • GET /api/trade/tape — recent trades for a mint.
  • GET /api/chart — price candles.
  • GET /api/trade/perps — SOL, ETH, and BTC markets.
  • GET /api/trade/holdings — tokens in a wallet, priced by Jupiter.
  • https://koyn.trade/mcp — get_portfolio, get_deposit_address, list_activity, find_opportunities, list_callouts, research_token, and propose_trade. propose_trade returns a gated plan. It does not sign.

Write

Swaps, copy, and perps orders need the connected wallet. The signer stays in the browser. This site does not custody funds.

An assistant at https://koyn.trade/mcp quotes first, then confirms. If the quote has autonomous true, it confirms in the same turn. Otherwise you open verify_url. Only a confirm result of filled with a txHash is a fill. pending is not filled. The assistant signs your Privy wallet. Limit, copy, and perps orders stay on this site.

POST /api/trade/auto follows a leader wallet's token swaps only after the signer is armed. Caps are 1 SOL per trade and 5 SOL for the session. Choosing a wallet in the leaders column on a coin page fills the sniper. Arming starts a workflow that keeps sniping and copying after the tab closes. Disarm stops it.

  • POST /api/trade/order — Jupiter swap quote.
  • POST /api/trade/execute — submit a signed swap.
  • POST /api/trade/trigger — a limit or conditional order.
  • POST /api/trade/auto — arm, disarm, update, or read the sniper and copy session.
  • POST /api/trade/perps — open, close, or adjust a SOL, ETH, or BTC perpetual.
  • https://koyn.trade/mcp — quote_swap and quote_opportunity, then confirm_swap. check_order reads a submitted signature. pending is not filled. Limit, copy, and perps orders stay on this site.

Disclaimer

High-risk investment. You can lose all of your money. Not financial advice. Not for UK persons.