home / docs
v1.0 documentation

Documentation

Everything about how fonk trades, charges fees, and pays airdrops. Start at the top, or jump to a section.

Overview

fonk is an autonomous AI memecoin trading agent. It manages a live memecoin book on Solana DEXs without a human in the loop: it reads market data, sizes positions, routes swaps, manages risk, and books profit on its own.

The book is funded by fees. Every transaction pays a flat 1% fee that becomes trading capital. When fonk books a profit, the majority is airdropped back to holders. The rest compounds so the book grows over time.

๐Ÿณ

The one-liner: fees fund the book, the agent trades the book, and profits are airdropped to the people holding.

Quickstart

  1. Hold $FONK in a supported wallet.
  2. Open the live terminal to watch the book trade in real time.
  3. At the end of each cycle, claim your airdrop โ€” it settles straight to your wallet.
# check your projected airdrop for the current cycle
fonk airdrop --status --wallet 0xโ€ฆ

How fonk works

fonk runs a continuous loop. Each pass through the loop is a decision cycle measured in seconds:

// simplified agent loop โ€” markets never close
while (true) {
  const signals = perceive(memeMarketData);
  const plan   = strategy.decide(signals, book, riskLimits);
  const swaps  = risk.check(plan);
  jupiter.execute(swaps);
  book.mark(); ledger.record();
}

1. Perceive

Ingests prices, volume, liquidity and momentum across a watchlist of Solana memecoins.

2. Decide

A momentum + mean-reversion strategy proposes target positions, ranked by expected edge and liquidity.

3. Risk-check

Proposed swaps are filtered through per-token caps, portfolio drawdown guards, slippage limits and the treasury floor.

4. Execute & record

Approved swaps are routed via Jupiter on Solana. Fills, P&L and fee/airdrop accounting are written to the ledger.

Trading engine core

The engine trades a rotating set of liquid Solana memecoins. It is built around three modules:

ModuleJobCadence
signalScores momentum, flow & mean-reversion opportunities~1s
sizerConverts scores into risk-weighted target sizesper signal
executorRoutes / retries swaps via Jupiter aggregatorsevent-driven

All positions are spot memecoins โ€” no leverage, no perps, no options in v1.0.

Fees

A flat 1% fee applies to each transaction and becomes trading capital. There are no management, holding or withdrawal fees. For the full breakdown and an interactive calculator, see the dedicated page.

# fee โ†’ capital โ†’ profit โ†’ airdrop
fee    = amount * 0.01
capital = fee        // 100% deployed
profit = capital * cycleReturn
airdrop = profit * 0.80  // 80% to holders

Open the fee page & calculator โ†’

Airdrops

At each cycle snapshot, realized profit is measured and 80% is distributed to holders pro-rata by holdings. Airdrops are non-custodial and settle directly to your wallet.

  • Snapshot: holdings are recorded at the cycle close.
  • Split: 80% to holders, 20% compounded into the treasury.
  • Claim: gas-only; no protocol fee to claim.
๐Ÿช‚

Hold to eat. Your share of each airdrop scales with the size of your holding at the snapshot.

Commands

Query fonk from the CLI or chat interface:

CommandDescription
fonk statusLive portfolio value, day P&L and open positions
fonk positionsFull open-position breakdown
fonk airdrop --statusYour projected airdrop this cycle
fonk fees --estimateEstimate the fee & rebate on an amount

Architecture

fonk is split into an agent brain, a risk layer, and a DEX router:

meme data โ”€โ”€โ–ถ agent โ”€โ”€โ–ถ risk layer โ”€โ”€โ–ถ DEX router โ”€โ”€โ–ถ Jupiter / Solana
              โ”‚                       โ–ผ
              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ถ ledger โ”€โ”€โ–ถ airdrop engine โ”€โ”€โ–ถ holders

The ledger is the source of truth for fees collected, P&L realized and airdrops owed.

Security

  • Non-custodial: fonk never holds holder keys. It controls only its own trading treasury.
  • Scoped wallet access: the treasury wallet is limited to swap actions on approved DEX routes.
  • Hard risk limits: per-token caps, slippage guards, drawdown limits and a treasury floor are enforced before any swap is sent.
  • Transparent ledger: fees, P&L and airdrops are auditable.

Risk

โš ๏ธ

Trading involves risk of loss. Past performance does not guarantee future results. fonk is an autonomous experiment; cycles can be unprofitable, in which case no airdrop is paid. Nothing here is investment advice.

FAQ

Is fonk affiliated with Jupiter or Solana?
No. fonk routes swaps through Solana DEXs (via aggregators like Jupiter) but is an independent agent and is not affiliated with or endorsed by Jupiter, Solana Labs, or any token issuer.
Do I need to do anything for airdrops?
Just hold. At each cycle snapshot your pro-rata airdrop is calculated automatically; you only pay gas to claim.
What does fonk trade?
Solana memecoins, spot-only in v1.0. No leverage, perps or options.
Can I withdraw anytime?
Yes. Holdings are non-custodial and there is no withdrawal fee or lockup.