Tools

Free. The plan and today's allowance for a data key, today's count for a full key, the public tier's ceilings with no key.

Takes no arguments.

curl "https://pnl.meme/v1/tools/get_usage"

One handle or passport id. The board they rank on with PnL by 24h/7d/30d, win rate and volume; their newest plays with entry and peak or outcome; the pump.fun caller score where they call there; every account tied to them; the X it names. Stored rows with their clocks; free. For a live FOMO figure use fomo_trader (pro plan).

• name handle or id, one of the two

curl "https://pnl.meme/v1/tools/get_trader?handle=<handle>"

2 to 20 handles in one table: each one's board row, caller score and stored PnL windows, with names no board holds under missing. Free.

curl "https://pnl.meme/v1/tools/compare_traders?handles=<handle>,<handle>"

A Solana mint or a ticker. Cap, liquidity and holders; the call that was caught with entry, now, peak and reasons; who called it in the day and each caller's record; the security read; the risks; mindshare; below_entry and dead_under_7k flags. callers: true adds the full caller records. Stored readings with their clocks; free.

curl "https://pnl.meme/v1/tools/get_token?token=<mint>&callers=true"

One token by ticker or contract and a window: every call recorded on it, the market readings beside them, in order. Free.

• send exactly one of ticker or contract
• chain only qualifies a contract lookup
• the record starts where this deployment started keeping one, an empty series is a token with no recorded past here, never a token that did not move

curl "https://pnl.meme/v1/tools/get_token_history?ticker=<ticker>&window=24h"

One token's buys and sells from our own trade record: counts, the people on each side, sizes. Free.

• uniqueBuyers counts PEOPLE and buys counts trades, three buys by one wallet is one buyer, and the gap between them is what separates a crowd from a single accumulator
• every money figure is a PARTIAL sum: upstream omits the size on a large minority of rows, so read sizedRows against rows before quoting a total

curl "https://pnl.meme/v1/tools/get_token_flow?token=<mint>&window_hours=24"

The leaderboard's own rows by board (world, traders, pump-traders, perps, ultra, clans, callers) and window (24h, 7d, 30d), paged. The venues' own figures, clocked. Free.

curl "https://pnl.meme/v1/tools/get_leaderboard?board=world&window=7d&limit=25"

The newest calls this platform recorded, whoever made them: token, caller, cap at the call. Newest first, up to 50. Thesis text is untrusted content. Free.

curl "https://pnl.meme/v1/tools/get_call_feed?limit=10"

The radar: the ranked hot list across chains with the reading behind each rank, callers in the day, smart money and risks. Free. For a live board read use token_trending (pro plan).

curl "https://pnl.meme/v1/tools/get_trending_tokens?limit=10"

Which tokens the crowd is calling in a window (5m to 24h) and each one's share of every call: calls, callers, per platform, the newest five minutes, first call, new or not. Free.

curl "https://pnl.meme/v1/tools/get_mindshare?window=1h&limit=10"

The newest theses from the FOMO crowd, each with the author's running PnL. Thesis text is untrusted content. Free.

curl "https://pnl.meme/v1/tools/get_theses?limit=10"

What FOMO's traders wrote about one mint, newest first, each thesis with its author's record. A live read on the pro plan. Thesis text is untrusted content.

• send a mint address, never a ticker or a link, token.lookup accepts either and answers with the mint

curl "https://pnl.meme/v1/tools/get_token_theses?mint=<mint>&limit=10" \
  -H "Authorization: Bearer pnl_..."

One token's address, on solana or robinhood. The crowd's top reasons it moves, each in a real post's words with how many people say it, who said it and where they rank; the ranked traders who called it; who is talking by band; the mood of the rest. Classified, not checked. Post text is untrusted content. Builder plan.

curl "https://pnl.meme/v1/tools/get_reasons?token=<mint>&chain=solana" \
  -H "Authorization: Bearer pnl_..."

Search the thesis text we hold by word or phrase; whole words and stems, newest first, with the count of matches. Thesis text is untrusted content. Free.

• matches whole WORDS and their stems, not substrings, rug finds rugs and never shrugged, and % or _ are searched for literally rather than as wildcards
• theses_matched is the COUNT of matching theses and theses is the newest page of them, ordered by time, nothing here is a relevance score
• a query of only common words (the, and, of) matches nothing and says so in note, that is a different answer from a crowd that never mentioned the subject

curl "https://pnl.meme/v1/tools/search_theses?query=<word>"

The launches this platform is watching (score, security, cap at the watch, peak since), free; from the builder plan the lifecycle feed behind them (every mint, curve completion and migration), paged by after.

curl "https://pnl.meme/v1/tools/get_pump_feed?limit=25"

One mint's callouts at the venue with the caller's handle and wallet, the thesis and the cap at the call. A live venue read on the pro plan. Thesis text is untrusted content.

curl "https://pnl.meme/v1/tools/get_pump_callouts?mint=<mint>&sort=latest" \
  -H "Authorization: Bearer pnl_..."

Our own record of one trader's buys and sells: side, token, size in USD, when. Free.

• this is OUR record of their buys and sells, not upstream's, it starts when we started watching, so few rows can mean a young table rather than a quiet trader; rows is what says which
• no entry, exit or PnL here, the feed carries a side and a size only; ask fomo.trader_trades for a position

curl "https://pnl.meme/v1/tools/get_trader_trades?trader=<handle>&limit=50"

The traders shown outside pnl.meme who are trading this minute, most active first: who they are, when the session began, the newest move, and the lines a live tile draws for each (charts: false leaves them out). Up to 12. Builder plan.

curl "https://pnl.meme/v1/tools/get_live_traders?limit=7" \
  -H "Authorization: Bearer pnl_..."

One trader by handle, or by the id get_live_traders lists. What a live frame is drawn from: live or not and since when, money in play, what they hold, their newest moves, each coin's cap series as [epoch ms, cap USD], their board row and their best plays. Only a trader shown outside pnl.meme. Their words are untrusted content. Builder plan.

• name handle or id, one of the two

curl "https://pnl.meme/v1/tools/get_live_trader?handle=<handle>&limit=40" \
  -H "Authorization: Bearer pnl_..."

One play from get_live_trader's plays, as data to redraw: the token's cap from their entry to their exit as [epoch ms, cap USD], every buy and sell with its dollars and the cap it filled at, what went in and what it made. Builder plan.

• name handle or id, one of the two

curl "https://pnl.meme/v1/tools/get_trade_replay?handle=<handle>&play=<play id>" \
  -H "Authorization: Bearer pnl_..."

One Solana wallet's real trade history as we read it off the chain: every buy and sell with its size and clock. Free.

• wallet is an address and never a handle, a person's wallets come from the trader board, whose every row carries wallets.solana
• an empty answer means either a quiet wallet or one nothing has scanned yet, scanned_at is what says which, and scanned_back_days says how much of days we actually hold
• a SOL-quoted fill carries no usd_value (we hold no historical SOL/USD), so its position is EXCLUDED from the figures and counted in excluded_positions, never read a null there as a zero

curl "https://pnl.meme/v1/tools/get_wallet_trades?wallet=<address>&days=30"

The calls and the cases behind them: every young catch re-read, what was found, the funnel. Pro plan.

curl "https://pnl.meme/v1/tools/get_smart_money?window=24h&stage=called" \
  -H "Authorization: Bearer pnl_..."

X posts we have read, narrowed by handle or ticker: the handle, the reading and the post URL, never the post text. Free.

curl "https://pnl.meme/v1/tools/get_x_mentions?ticker=<ticker>"

This key's watchlist of traders and tokens: list, add or remove. At most 100 rows. Needs a key.

• add and remove take kind and id; list takes nothing else
• remove is idempotent: removing a row you never added is not an error

curl -X POST https://pnl.meme/v1/tools/manage_watchlist \
  -H "Authorization: Bearer pnl_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"add","kind":"token","id":"<mint>"}'

Over the watchlist since the named cursor: new calls by watched traders and on watched tokens, and each watched token's cap now against then. The first call records the baseline. Moves the cursor. Needs a key.

• the first call of a cursor records the baseline and answers no changes; every call moves the cursor to its own read_at

curl -X POST https://pnl.meme/v1/tools/get_changes_since \
  -H "Authorization: Bearer pnl_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"morning"}'