copytop

read what top fomo and pumpfun traders are buying, from n8n. read-only: nothing here places an order.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: copy.top

Documentation

n8n-nodes-copytop

Read what top fomo and pumpfun traders are buying, from n8n.

copy.top tracks what top traders buy and sell on fomo, pumpfun and Hyperliquid, and lets people copy them.
This package is an n8n community node for copy.top's public data. It is read-only: nothing
here places an order, moves funds or needs a wallet.

Figures are data, not advice. Trading memecoins is risky and past performance does not predict results.

copy.top is independent: it is not affiliated with fomo or pump.fun.

Installation

Follow the community nodes installation guide
and install n8n-nodes-copytop.

Credentials

The data is open: the nodes work with no credential at all, with a lower rate limit (about 20 calls a minute
per IP, and about 6 a minute for Search, Get Trader and Get Coin).

An API key is optional. Create one at https://copy.top/account#api, then add a copy.top API credential in
n8n and paste the key. The key is sent as Authorization: Bearer <key>, and only when one is set. An empty
credential is a valid setup.

Operations

Node: copy.top. Each operation returns one n8n item per element of the main list of the answer.

Resource Operation What it returns Parameters
Trader Get One item: the profile of a trader (30 day PnL, ROI, win rate, fair play verdict, badges, followers, copiers, positions, latest trades) Handle
Trader Get Leaderboard One item per ranked trader Window (1d, 7d, 30d), Sort By (total PnL, realized PnL, ROI, win rate, copiers), Limit (1 to 20), Platform (fomo, pumpfun), Chain, Fair Play
Coin Get One item: market data of a coin and the tracked traders who hold it or sold it Chain, Address
Coin Get Hot Coins One item per coin tracked traders are buying now Window (1h, 24h), Max Market Cap
Market Search One item per match, with resultType set to trader or coin Query (2 to 80 characters)
Market Get Money Flow One item per coin, ranked by dollars bought or sold Side (buy, sell), Window (1h, 6h, 24h, 7d)
Market Get Hot Index One item per coin, ranked 0 to 100 by attention Window (1h, 6h, 24h), Chain
Market Get Theses One item per thesis posted by a tracked trader Sort By (newest, most popular), Hours (1 to 24)
Market Get Live Trades One item per recent buy or sell by a tracked trader Side, Min Trade Size, Since
Alert Get Many One item per alert (confluence, big trade, thesis) Kinds, Min Top Traders, Min Trade Size, Max Market Cap, Since

A handle starting with pf_ is a pumpfun account. The others are fomo traders. Use Search first to turn a
name, an @handle, a $ticker or an address into the handle or the chain and address the other operations take.

Trigger

Node: copy.top Trigger. It is a polling trigger: n8n calls copy.top at the interval set in Poll Times.

Event Fires when Options
New Alert Several top traders bought the same coin, a tracked trader made a big trade, or posted a thesis Kinds, Min Top Traders, Min Trade Size, Max Market Cap
New Hot Coin A coin enters the list of coins tracked traders are buying now. Fires once per coin. Window, Max Market Cap
New Big Trade A tracked trader bought or sold at least the amount you set Side, Min Trade Size

How it behaves:

  • The first poll after activation records what already exists and emits nothing. The trigger fires for what
    comes next.
  • New Alert and New Big Trade keep the server cursor in the workflow static data and send it back as since.
    The ids of the last 1000 emitted entries are kept as well, so an entry is never emitted twice.
  • New Hot Coin keeps the list of coins already seen. A coin that left the list for 7 days may fire again.
  • New Big Trade reads a live tape that keeps the latest 30 trades: poll every minute.
  • A manual run ("Fetch Test Event") returns the latest entries and does not touch the stored state.
  • Changing the event of an existing trigger resets its stored state.

Use as an AI tool

The copy.top node sets usableAsTool: true, so it can be attached to an AI Agent node as a tool. On a
self-hosted n8n, community nodes are allowed as tools only when the environment variable
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true is set.

Links

Discussion