@flork/ai — flork.fun Agentic

Agent skill + CLI to create and trade memecoins on flork.fun — the Solana fair-launch launchpad on Meteora's Dynamic Bonding Curve. Create tokens, quote trades, buy, sell and transfer from your agent workflow, without leaving the terminal.

Works with Claude Code, Cursor, OpenClaw and any other CLI-capable agent.

⚠️ Real funds, mainnet. Every write command signs a real Solana transaction with your key. Your SOLANA_PRIVATE_KEY stays in your local environment and is never transmitted — only the signed transaction goes to the RPC. Use a burner wallet with only what you're willing to trade.

Install

npm install -g @flork/ai@latest

Or clone and run locally:

git clone https://github.com/Florkfun/agentic.git
cd agentic
npm install
node bin/florkfun.mjs help

Configure

Copy .env.example to .env and set your key:

# base58 (Phantom/Solflare export) or the JSON byte array from solana-keygen
SOLANA_PRIVATE_KEY=your_key_here

# optional — defaults to https://flork.fun
# FLORK_API=https://flork.fun
# optional — your own RPC (recommended for volume); else uses flork's RPC proxy
# SOLANA_RPC_URL=

The key is loaded only to sign locally. It is never sent anywhere.

Commands

Every command prints JSON to stdout so an agent can parse it deterministically. Progress notes go to stderr.

Read (no key required)

flork list --sort volume --limit 20            # trending tokens
flork list --status new --quote sol            # newest SOL-paired tokens
flork list --q pepe                            # search by name/symbol/mint
flork token <mint>                             # full detail of one token
flork leaderboard --page 0                     # points leaderboard
flork koth                                     # current King of the Hill
flork wallet                                   # your address + SOL & token balances

Trade (requires SOLANA_PRIVATE_KEY)

flork quote <mint> buy 0.5                      # preview a buy of 0.5 (quote units)
flork buy  <mint> 0.5 --slippage 100            # buy with 1% slippage
flork sell <mint> 1000000 --priority High       # sell 1,000,000 base tokens
flork transfer <recipient> 0.1                  # send 0.1 SOL
flork transfer <recipient> 500 --token <mint>   # send 500 of an SPL token

quote/buy amounts are in the pool's quote units (SOL or USDC). sell amounts are in base token units.

Create a token

flork create \
  --name "DOGFLORK" \
  --symbol DOGFLORK \
  --image ./logo.png \
  --quote sol \
  --initial-buy 0.5 \
  --desc "The Dog Flork" \
  --twitter https://x.com/yourhandle \
  --telegram https://t.me/yourgroup

This uploads the logo + Metaplex metadata, creates the Meteora DBC pool (with an optional anti-frontrun initial buy in the same transaction), and registers it on flork. The token mints and pool are created atomically. Returns the mint, pool, transaction signature and the token URL.

Quotes and their limits (--quote sol|usdc) come live from https://flork.fun/api/agentic/config.

How it works

• Reads hit flork.fun's public API (/api/tokens, /api/leaderboard, /api/koth).
• Quotes, buys, sells and creation are built with the Meteora Dynamic Bonding Curve SDK directly against the chain — the exact same calls flork's frontend makes — and signed locally with your key.
• Token creation uploads metadata through flork's /api/upload (authenticated with a one-time wallet signature → session cookie), then builds the pool creation transaction on-chain.
• Config (quote mints, DBC config keys, program, RPC proxy) is fetched from flork so the CLI stays in sync with the deployed launchpad.

Use it from an agent

Add the skill in skills/florkfun-integration/SKILL.md to Claude Code / OpenClaw and just ask in natural language:

"Launch a coin called DOGFLORK with this logo and buy 0.5 SOL of it, then show me the King of the Hill."

The agent maps the request to the commands above and returns structured JSON.

Security

• The private key never leaves your machine and is never logged.
• Prefer a dedicated burner wallet.
• .env is git-ignored — never commit your key.
• This is unaudited software provided as-is (MIT). Not financial advice. Crypto is volatile and high-risk. Do your own research.

License

MIT © flork.fun — see LICENSE.