{"openapi":"3.0.3","info":{"title":"copy.top API","version":"864e940","description":"copy.top tracks what top traders buy and sell on fomo, pumpfun and Hyperliquid, and lets people copy them. this api is read-only: nothing here places an order. it is open without a key, with low limits; a free key from https://copy.top/account#api raises them. figures are data, not advice. trading crypto is risky and past performance does not predict results. copy.top is independent: not affiliated with fomo, pump.fun or Hyperliquid.","contact":{"name":"copy.top","url":"https://copy.top/developers","email":"ana@copy.top"},"license":{"name":"MIT"}},"servers":[{"url":"https://copy.top/v1"}],"externalDocs":{"description":"developer guides","url":"https://copy.top/developers"},"tags":[{"name":"traders"},{"name":"coins"},{"name":"feed"},{"name":"hyperliquid"}],"paths":{"/traders":{"get":{"operationId":"listTraders","tags":["traders"],"summary":"Trader leaderboard (fomo and pumpfun)","description":"rank traders like copy.top's discover page. window 1d, 7d or 30d; sort total (pnl), realized, roi, winrate or copiers; optional chain or platform (fomo, pumpfun); fair_play clean or clean_or_watch keeps only those.","parameters":[{"name":"window","in":"query","required":false,"description":"default 30d","schema":{"type":"string","enum":["1d","7d","30d"]}},{"name":"sort","in":"query","required":false,"description":"default total","schema":{"type":"string","enum":["total","realized","roi","winrate","copiers"]}},{"name":"chain","in":"query","required":false,"description":"chain id as the tools give it","schema":{"type":"string","enum":["robinhood","solana","base","bnb","eth","arc"]}},{"name":"platform","in":"query","required":false,"description":"platform","schema":{"type":"string","enum":["fomo","pumpfun"]}},{"name":"fair_play","in":"query","required":false,"description":"fair_play","schema":{"type":"string","enum":["clean","clean_or_watch"]}},{"name":"limit","in":"query","required":false,"description":"default 10","schema":{"type":"integer","minimum":1,"maximum":20}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/traders/{handle}":{"get":{"operationId":"getTrader","tags":["traders"],"summary":"One trader: pnl, win rate, positions, trades","description":"a trader's copy.top profile (fomo or pump.fun): pnl 30d (realized, unrealized, total), roi, win rate, fair play verdict and badges, followers, copiers, platforms, largest open positions, latest trades and theses.","parameters":[{"name":"handle","in":"path","required":true,"description":"the trader's handle, as search or another tool gave it","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/search":{"get":{"operationId":"search","tags":["traders"],"summary":"Find traders and coins by name, handle, ticker or address","description":"find traders and coins on copy.top by name, handle, @x, $ticker or address. use it to resolve a name before the other tools.","parameters":[{"name":"query","in":"query","required":true,"description":"2 to 80 characters","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/coins/hot":{"get":{"operationId":"listHotCoins","tags":["coins"],"summary":"Coins tracked traders are buying now","description":"the signal feed: coins tracked traders are buying now. window 1h or 24h, optional max market cap in dollars. each coin: how many traders and top traders bought, dollars bought and sold, minutes since the first buy, and the first buyers.","parameters":[{"name":"window","in":"query","required":false,"description":"default 24h","schema":{"type":"string","enum":["1h","24h"]}},{"name":"max_mcap_usd","in":"query","required":false,"description":"max_mcap_usd","schema":{"type":"number"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/coins/index":{"get":{"operationId":"getHotIndex","tags":["coins"],"summary":"Coins ranked 0 to 100 by attention","description":"copy.top's hot index: coins ranked 0-100 by attention right now, mixing tracked traders buying, callers and x activity (voices, views). window 1h, 6h or 24h; optional chain.","parameters":[{"name":"window","in":"query","required":false,"description":"window","schema":{"type":"string","enum":["1h","6h","24h"]}},{"name":"chain","in":"query","required":false,"description":"chain id as the tools give it","schema":{"type":"string","enum":["robinhood","solana","base","bnb","eth","arc"]}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/coins/flow":{"get":{"operationId":"getMoneyFlow","tags":["coins"],"summary":"Coins ranked by dollars bought or sold","description":"where tracked traders' dollars go: coins ranked by dollars bought (side buy) or sold (side sell) over 1h, 6h, 24h or 7d, with the number of traders.","parameters":[{"name":"side","in":"query","required":false,"description":"default buy","schema":{"type":"string","enum":["buy","sell"]}},{"name":"window","in":"query","required":false,"description":"default 24h","schema":{"type":"string","enum":["1h","6h","24h","7d"]}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/coins/dex-paid":{"get":{"operationId":"listDexPaid","tags":["coins"],"summary":"Coins whose team paid for a dexscreener profile in the last 24 h","description":"coins whose team paid for a dexscreener profile in the last 24 h (a sign the team is spending), with price, market cap, liquidity, volume and moves.","parameters":[],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/coins/{chain}/{address}":{"get":{"operationId":"getCoin","tags":["coins"],"summary":"One coin: price, market cap, which tracked traders hold it","description":"a coin's copy.top page: price, market cap, 1h and 24h moves, liquidity, which tracked traders hold it or sold it and their pnl on it, and their theses.","parameters":[{"name":"chain","in":"path","required":true,"description":"chain id as the tools give it","schema":{"type":"string"}},{"name":"address","in":"path","required":true,"description":"address","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/trades":{"get":{"operationId":"listTrades","tags":["feed"],"summary":"Latest buys and sells by tracked traders","description":"the live tape: the latest buys and sells by tracked traders (fomo and pump.fun), newest first. optional since (iso time or the cursor of a previous call) to get only newer trades, side buy or sell, min_usd.","parameters":[{"name":"since","in":"query","required":false,"description":"iso time, e.g. the cursor from the previous call","schema":{"type":"string"}},{"name":"side","in":"query","required":false,"description":"side","schema":{"type":"string","enum":["buy","sell"]}},{"name":"min_usd","in":"query","required":false,"description":"min_usd","schema":{"type":"number"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/alerts":{"get":{"operationId":"listAlerts","tags":["feed"],"summary":"Events since a cursor: several top traders on one coin, big trades, theses","description":"events since a cursor, for alert bots: confluence (several top traders bought the same coin recently), big_trade (one tracked trader bought or sold a large amount) and thesis (a tracked trader posted a thesis). pass the cursor of the previous call as since; without since, the last 15 minutes. thresholds are yours.","parameters":[{"name":"since","in":"query","required":false,"description":"the cursor of the previous call (iso time)","schema":{"type":"string"}},{"name":"min_top_traders","in":"query","required":false,"description":"confluence threshold, default 3","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"min_trade_usd","in":"query","required":false,"description":"big trade threshold in dollars, default 5000","schema":{"type":"number"}},{"name":"max_mcap_usd","in":"query","required":false,"description":"ignore coins above this market cap","schema":{"type":"number"}},{"name":"kinds","in":"query","required":false,"description":"comma separated","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/theses":{"get":{"operationId":"listTheses","tags":["feed"],"summary":"Theses posted by tracked traders","description":"the latest or most popular theses (a trader's written reason for holding a coin) posted by tracked traders in the last 24 h at most, with the coin and their pnl at post.","parameters":[{"name":"sort","in":"query","required":false,"description":"default new","schema":{"type":"string","enum":["new","popular"]}},{"name":"hours","in":"query","required":false,"description":"default 24","schema":{"type":"integer","minimum":1,"maximum":24}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/hyperliquid/traders":{"get":{"operationId":"listHyperliquidTraders","tags":["hyperliquid"],"summary":"Hyperliquid traders ranked by pnl or roi","description":"rank hyperliquid perps traders tracked by copy.top. window 24h, 7d, 30d or all; sort pnl or roi. each row: address, name, account value, pnl, roi, volume, win rate, style, trades per day, max drawdown 30d, top coins.","parameters":[{"name":"window","in":"query","required":false,"description":"default 30d","schema":{"type":"string","enum":["24h","7d","30d","all"]}},{"name":"sort","in":"query","required":false,"description":"default pnl","schema":{"type":"string","enum":["pnl","roi"]}},{"name":"limit","in":"query","required":false,"description":"default 10","schema":{"type":"integer","minimum":1,"maximum":20}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/hyperliquid/traders/{address}":{"get":{"operationId":"getHyperliquidTrader","tags":["hyperliquid"],"summary":"One Hyperliquid trader: metrics, positions, fills","description":"a hyperliquid trader by address: profile and metrics (win rate, profit factor, drawdown, usual leverage, score), pnl per window, open positions with entry, size, leverage and liquidation price, and latest fills.","parameters":[{"name":"address","in":"path","required":true,"description":"0x + 40 hex","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/hyperliquid/markets":{"get":{"operationId":"listHyperliquidMarkets","tags":["hyperliquid"],"summary":"Live Hyperliquid markets","description":"live hyperliquid markets (crypto perps and hip-3: stocks, indices, commodities, fx): mark price, 24h change, 24h volume, open interest, hourly funding, max leverage. optional category; sorted by 24h volume.","parameters":[{"name":"category","in":"query","required":false,"description":"e.g. crypto, stocks, indices, commodities, fx","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"default 20","schema":{"type":"integer","minimum":1,"maximum":50}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/hyperliquid/markets/{coin}":{"get":{"operationId":"getHyperliquidMarket","tags":["hyperliquid"],"summary":"One Hyperliquid market read","description":"copy.top's read of one major hyperliquid market: technicals (rsi, emas, trend), funding vs its history and other venues, premium, open interest changes, what the top 300 traders hold and their latest moves, nearby liquidations, fear and greed.","parameters":[{"name":"coin","in":"path","required":true,"description":"e.g. BTC, ETH, SOL","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/hyperliquid/markets/{coin}/calls":{"get":{"operationId":"listHyperliquidCalls","tags":["hyperliquid"],"summary":"Analyst calls on one Hyperliquid market","description":"x analysts ranked by the track record of their calls on one hyperliquid market, and their recent calls.","parameters":[{"name":"coin","in":"path","required":true,"description":"e.g. BTC, ETH, SOL","schema":{"type":"string"}}],"security":[{},{"bearerAuth":[]}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"optional. a free key from https://copy.top/account#api"}},"responses":{"Error":{"description":"error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}