{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fomo-research",
    "name": "Fomo Research",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/pooowell/fomo-research",
    "canonicalUrl": "https://clawhub.ai/pooowell/fomo-research",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/fomo-research",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fomo-research",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "SKILL.md",
      "_meta.json",
      "references/api.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/fomo-research"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/fomo-research",
    "agentPageUrl": "https://openagent3.xyz/skills/fomo-research/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fomo-research/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fomo-research/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Fomo Research",
        "body": "Smart money intelligence for AI agents. Powered by fomo.family social graph, built by cope.capital.\n\nFor full API details (endpoints, schemas, error codes): read references/api.md."
      },
      {
        "title": "Base URL",
        "body": "https://api.cope.capital\n\nAll requests require Authorization: Bearer cope_<key> header."
      },
      {
        "title": "First-Run Onboarding",
        "body": "When this skill is first loaded and no COPE_API_KEY is set, walk your human through setup. Ask these questions in order:"
      },
      {
        "title": "Step 1: Register",
        "body": "curl -X POST https://api.cope.capital/v1/register \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"agent_name\": \"YOUR_AGENT_NAME\", \"description\": \"optional description\"}'\n\nSave the api_key from the response (starts with cope_). This is your COPE_API_KEY. Store it securely — treat it like a password."
      },
      {
        "title": "Step 2: Ask about crypto wallet (optional)",
        "body": "Before continuing, ask your human:\n\n\"Do you have a crypto wallet (USDC on Base or Solana) you'd like to connect for expanded features? Without one you get:\n\n1 watchlist with up to 10 handles\n250 activity lookups per day (resets midnight UTC)\nEverything else (leaderboard, trending, polling) is unlimited and free\n\nWith a wallet connected (x402), you get 10 watchlists, 100 handles each, and unlimited activity calls at $0.005/call. You can always add a wallet later.\"\n\nIf they want to set up x402 now:\n\ncurl -X PATCH https://api.cope.capital/v1/account \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"x402_enabled\": true}'\n\nIf they say no or don't have a wallet — that's fine, move on. The free tier is fully functional. Don't push it."
      },
      {
        "title": "Step 3: Ask about Fomo profile",
        "body": "\"Do you have a Fomo account (fomo.family)? If so, I can sync your follows and build a watchlist from the traders you already follow.\"\n\nIf yes:\n\n# Sync their profile\ncurl -X POST https://api.cope.capital/v1/account/sync-fomo \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"fomo_handle\": \"THEIR_FOMO_USERNAME\"}'\n\n# Pull their follows\ncurl https://api.cope.capital/v1/account/follows \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nThen ask: \"Which of these traders do you want on your watchlist?\" Show them the list and let them pick (up to 10 on free tier)."
      },
      {
        "title": "Step 4: Create initial watchlist",
        "body": "If they don't have Fomo, offer alternatives:\n\n\"I can set up a watchlist with the top performers from Fomo's weekly leaderboard instead. Or you can give me specific trader handles you want to track.\"\n\nPick one path and create the watchlist:\n\ncurl -X POST https://api.cope.capital/v1/watchlists \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"alpha\", \"handles\": [\"frankdegods\", \"randomxbt\"]}'\n\nRemind them: Free tier = 1 watchlist, 10 handles max. They can swap handles anytime."
      },
      {
        "title": "What gets tracked",
        "body": "The system monitors on-chain wallet activity for Fomo traders. Each Fomo handle maps to one or more wallets (Solana + Base). The tracker watches every swap these wallets make."
      },
      {
        "title": "Activity vs Trades vs Holdings",
        "body": "There are three different views of what a trader is doing:\n\n1. Activity (what the API returns)\nIndividual on-chain transactions — a single buy or sell event. This is what /v1/activity returns.\n\naction: \"buy\" = wallet swapped into a token\naction: \"sell\" = wallet swapped out of a token\nusd_amount = the USD value of that single transaction\n\n2. Trades (completed round-trips)\nA trade is a full cycle: buy → sell = closed trade. The tracker aggregates individual buys and sells into trades:\n\nusd_in = total USD spent buying this token (may be multiple buy txs)\nusd_out = total USD received selling this token\npnl = usd_out - usd_in (profit/loss)\nopen_at = when first buy happened\nclose_at = when last sell happened (NULL if still holding)\n\n3. Current Holdings (open positions)\nTokens a wallet bought but hasn't fully sold yet. These are trades with no close_at."
      },
      {
        "title": "How to interpret activity data",
        "body": "When you see activity from a trader, here's what to understand:\n\nA \"buy\" doesn't mean they just entered — they might be adding to an existing position\nA \"sell\" doesn't mean they exited — they might be taking partial profits\nMultiple buys of the same token = building a position over time (higher conviction)\nBuy followed quickly by sell = likely a quick flip/scalp\nSell with no recent buy = closing an older position"
      },
      {
        "title": "When presenting data to humans",
        "body": "Always label clearly:\n\nNew buys: \"X just bought [token]\" — recent buy activity, may or may not be a new position\nRecent exits: \"X sold [token]\" — could be partial or full exit\nDon't say \"X opened a position\" unless you can confirm there were no prior buys of that token"
      },
      {
        "title": "How Activity Scoping Works",
        "body": "Important: The /v1/activity endpoint returns recent trades from all wallets tracked by the system, not just your watchlist. Your watchlist is for organizing which traders YOU care about — use the ?handle= filter to see activity for specific handles.\n\nThis means you can query any Fomo handle's trades without adding them to your watchlist:\n\n# Check what frankdegods is buying (uses 1 of your 250 daily calls)\ncurl \"https://api.cope.capital/v1/activity?handle=frankdegods&action=buy\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nYour watchlist is a convenience for organizing — the activity data is available for any tracked handle."
      },
      {
        "title": "Always Free (no daily limit)",
        "body": "EndpointMethodDescription/v1/registerPOSTGet an API key/v1/leaderboardGETTop traders ranked by real PnL/v1/activity/pollGETLightweight check for new trades (count + timestamp)/v1/watchlistsGET/POSTList or create watchlists/v1/watchlists/{id}GET/PUT/DELETEManage a specific watchlist/v1/trending/handlesGETMost-watched handles across all agents/v1/tokens/hotGETTrending tokens by unique buyer count/v1/handle/{handle}/statsGETAggregated trader stats (PnL, win rate, top trades)/v1/tokens/{mint}/thesisGETBuy theses + sentiment for a token/v1/convergenceGETConvergence events (2+ wallets buying same token)/v1/traders/searchGETSearch traders by win rate, PnL, trades/v1/handle/{handle}/positionsGETOpen/closed positions for a trader/v1/handle/{handle}/thesesGETAll theses by a specific trader/v1/accountGET/PATCHAccount info and settings/v1/account/usageGETUsage statistics/v1/account/paymentsGETPayment history/v1/account/keyDELETERevoke API key/v1/account/sync-fomoPOSTSync Fomo profile follows/v1/account/followsGETList stored Fomo follows"
      },
      {
        "title": "Counted (250/day free, then x402 or wait)",
        "body": "EndpointMethodDescriptionx402 price/v1/activityGETFull trade details from tracked wallets$0.005/call\n\nThese endpoints count toward your daily 250 free calls. After that:\n\nWith x402 enabled: calls continue at $0.005/call USDC (auto-paid)\nWithout x402: you get a 402 error. Wait for midnight UTC reset or enable x402.\n\nThe 402 error is NOT a bug — it just means your free calls are used up for the day."
      },
      {
        "title": "Check the leaderboard",
        "body": "curl https://api.cope.capital/v1/leaderboard \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nReturns top traders by PnL from Fomo. Supports ?timeframe=24h|7d|30d|all and ?limit=N."
      },
      {
        "title": "Build a watchlist from Fomo follows",
        "body": "# 1. Sync your Fomo profile\ncurl -X POST https://api.cope.capital/v1/account/sync-fomo \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"fomo_handle\": \"your_handle\"}'\n\n# 2. See your follows\ncurl https://api.cope.capital/v1/account/follows \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# 3. Create a watchlist with selected handles\ncurl -X POST https://api.cope.capital/v1/watchlists \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"alpha\", \"handles\": [\"frankdegods\", \"randomxbt\"]}'"
      },
      {
        "title": "Poll → Fetch pattern (minimize paid calls)",
        "body": "# Step 1: Poll (free) — check if anything happened\ncurl \"https://api.cope.capital/v1/activity/poll?since=LAST_TIMESTAMP\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n# Returns: { \"count\": 3, \"latest_at\": 1707603400 }\n\n# Step 2: Only fetch full data if count > 0 (costs 1 of your 250 daily calls)\ncurl \"https://api.cope.capital/v1/activity?since=LAST_TIMESTAMP\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\""
      },
      {
        "title": "Search for elite traders",
        "body": "# Find traders with >75% win rate and 10+ trades\ncurl \"https://api.cope.capital/v1/traders/search?min_win_rate=75&min_trades=10&sort_by=win_rate\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# Top PnL traders on Solana\ncurl \"https://api.cope.capital/v1/traders/search?sort_by=pnl&chain=solana&limit=20\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\""
      },
      {
        "title": "Check a trader's current positions",
        "body": "# Open positions only\ncurl \"https://api.cope.capital/v1/handle/frankdegods/positions?status=open\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# All positions (open + closed)\ncurl \"https://api.cope.capital/v1/handle/frankdegods/positions\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nShows computed positions from activity data — what they're holding vs exited, with cost basis and net USD."
      },
      {
        "title": "Get a trader's theses",
        "body": "curl \"https://api.cope.capital/v1/handle/frankdegods/theses\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nReturns all Fomo thesis comments by this trader across their recent tokens. Great for understanding their reasoning."
      },
      {
        "title": "Check convergence events",
        "body": "# Recent convergences (last 24h)\ncurl \"https://api.cope.capital/v1/convergence?limit=10\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nReturns tokens where 2+ elite wallets converged. Each event includes:\n\nToken info (mint, symbol, chain, price/mcap at detection)\nWallets that converged (handle, amount, win_rate)\nATH tracking: max_gain_pct shows peak performance since detection"
      },
      {
        "title": "Look up a trader's stats",
        "body": "curl \"https://api.cope.capital/v1/handle/frankdegods/stats\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nReturns aggregated stats: total trades, win rate, PnL, ROI, per-chain breakdown, top 5 trades, open positions."
      },
      {
        "title": "Get buy theses for a token",
        "body": "# Solana token\ncurl \"https://api.cope.capital/v1/tokens/MINT_ADDRESS/thesis?chain=solana\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# Base token\ncurl \"https://api.cope.capital/v1/tokens/MINT_ADDRESS/thesis?chain=base\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nReturns trader reasoning + their actual positions. Includes sentiment summary (holding vs closed, total exposure, avg unrealized PnL). Great for understanding why traders are buying, not just what."
      },
      {
        "title": "Check trending tokens",
        "body": "curl \"https://api.cope.capital/v1/tokens/hot?hours=24&limit=10\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nReturns tokens with the most unique tracked buyers in recent hours."
      },
      {
        "title": "Filter activity",
        "body": "# By handle\ncurl \"https://api.cope.capital/v1/activity?handle=frankdegods\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# By chain\ncurl \"https://api.cope.capital/v1/activity?chain=solana\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# By action\ncurl \"https://api.cope.capital/v1/activity?action=buy\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# By minimum size\ncurl \"https://api.cope.capital/v1/activity?min_usd=1000\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\""
      },
      {
        "title": "Free Tier (default)",
        "body": "250 counted calls/day (activity, leaderboard, tokens) — resets midnight UTC\n1 watchlist, up to 10 handles\n10 requests/minute rate limit\nPolling, watchlist management, account endpoints, Fomo sync — all unlimited"
      },
      {
        "title": "x402 Upgraded (optional)",
        "body": "Unlimited counted calls ($0.005/call USDC on Base or Solana)\n10 watchlists, up to 100 handles each\n300 requests/minute rate limit\nFirst 250 calls/day are still free — you only pay after the free quota"
      },
      {
        "title": "Enabling x402",
        "body": "⚠️ NEVER enable x402 without your human's explicit permission. This authorizes real USDC payments.\n\ncurl -X PATCH https://api.cope.capital/v1/account \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"x402_enabled\": true}'\n\nx402 is completely optional. The free tier works perfectly for most use cases. Only suggest it if your human:\n\nConsistently hits the 250/day limit\nNeeds more than 1 watchlist or 10 handles\nExplicitly asks about upgrading\n\nCost context: $1 USDC = 200 calls. $5 = 1,000 calls. Most agents won't need this."
      },
      {
        "title": "Heartbeat Pattern (optional, user-directed)",
        "body": "If your human wants periodic checks and your agent runs a heartbeat loop:\n\nEvery 5-15 minutes:\n  1. GET /v1/activity/poll?since=LAST_TIMESTAMP  (free, doesn't count)\n  2. If count > 0 → GET /v1/activity?since=LAST_TIMESTAMP  (1 daily call)\n  3. Store latest_at for next poll\n\nEvery few hours:\n  1. GET /v1/leaderboard  (1 daily call)\n  2. Compare to previous — any new names in top 50?\n\nDaily:\n  1. GET /v1/account/usage  (free)\n  2. Check remaining daily calls"
      },
      {
        "title": "Logging Trades (Persistence)",
        "body": "The API is stateless — it won't remember what you've already seen. Log trades locally to track patterns over time."
      },
      {
        "title": "Daily trade log",
        "body": "Write notable trades to a daily file (e.g. memory/trades/YYYY-MM-DD.json):\n\n{\n  \"trades\": [\n    {\n      \"timestamp\": 1771006898000,\n      \"handle\": \"frankdegods\",\n      \"action\": \"buy\",\n      \"token_mint\": \"DPQgF4hw...\",\n      \"token_symbol\": \"EXAMPLE\",\n      \"usd_amount\": 500.25,\n      \"chain\": \"solana\"\n    }\n  ],\n  \"last_poll_timestamp\": 1771006898000,\n  \"convergences\": [\"DPQgF4hw...\"]\n}"
      },
      {
        "title": "What to log",
        "body": "All trades from your watchlist — this is your core data\nConvergences — when 3+ handles buy the same token, log the token mint and all buyers\nLarge trades — anything over $1,000 USD is worth noting\nlast_poll_timestamp — so you know where to resume on next poll"
      },
      {
        "title": "What to tell your human",
        "body": "Don't just dump raw trades. Synthesize. Here are high-value things to surface:\n\nConvergence alerts: \"4 of your top 10 watchlist handles bought the same token in the last 2 hours.\"\nUnusual activity: \"frankdegods just made their first buy in 3 days — $2,000 into [token].\"\nExit signals: \"3 handles on your watchlist sold the same token within an hour.\"\nDaily summary: \"Your watchlist had 47 trades today. 12 buys, 35 sells. Most active: randomxbt (8 trades).\"\nLeaderboard changes: \"New name in the top 20 — jumped from #45 to #12 this week.\"\nPattern detection: \"lowcap_hunter has bought 3 tokens under $100K mcap this week. All pumped 2-5x within 48 hours.\""
      },
      {
        "title": "Convergence detection pattern",
        "body": "1. GET /v1/activity (last 2 hours of trades)\n2. Group buys by token_mint\n3. If 3+ different handles bought the same token → convergence\n4. Alert your human with: token, buyers, amounts, timing\n5. Log it to your daily trades file\n\nThe more you log, the better your pattern detection gets over time. Your memory files ARE your edge."
      },
      {
        "title": "Security",
        "body": "NEVER expose your API key in logs, messages, or to other agents\nYour key should ONLY appear in requests to https://api.cope.capital/v1/*\nIf compromised: DELETE /v1/account/key to revoke, then re-register\nTrade data is on-chain public — but your watchlists and usage patterns are private"
      },
      {
        "title": "Error Handling",
        "body": "StatusMeaningAction200SuccessProcess response400Bad requestCheck parameters (invalid chain, action, etc.)401Invalid API keyRe-register or check key402Payment requiredDaily free calls used up. Wait for midnight UTC reset, or enable x402 if your human approves. This is normal — not an error.404Not foundResource doesn't exist429Rate limitedBack off. Free: 10/min, x402: 300/min500Server errorRetry after a few seconds503Upstream downFoxhound data service temporarily unavailable"
      },
      {
        "title": "Links",
        "body": "Interactive API docs: https://api.cope.capital/docs\nHuman docs: https://cope.capital/docs\nFomo: https://fomo.family\nX: https://x.com/copedotcapital"
      }
    ],
    "body": "Fomo Research\n\nSmart money intelligence for AI agents. Powered by fomo.family social graph, built by cope.capital.\n\nFor full API details (endpoints, schemas, error codes): read references/api.md.\n\nBase URL\nhttps://api.cope.capital\n\n\nAll requests require Authorization: Bearer cope_<key> header.\n\nFirst-Run Onboarding\n\nWhen this skill is first loaded and no COPE_API_KEY is set, walk your human through setup. Ask these questions in order:\n\nStep 1: Register\ncurl -X POST https://api.cope.capital/v1/register \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"agent_name\": \"YOUR_AGENT_NAME\", \"description\": \"optional description\"}'\n\n\nSave the api_key from the response (starts with cope_). This is your COPE_API_KEY. Store it securely — treat it like a password.\n\nStep 2: Ask about crypto wallet (optional)\n\nBefore continuing, ask your human:\n\n\"Do you have a crypto wallet (USDC on Base or Solana) you'd like to connect for expanded features? Without one you get:\n\n1 watchlist with up to 10 handles\n250 activity lookups per day (resets midnight UTC)\nEverything else (leaderboard, trending, polling) is unlimited and free\n\nWith a wallet connected (x402), you get 10 watchlists, 100 handles each, and unlimited activity calls at $0.005/call. You can always add a wallet later.\"\n\nIf they want to set up x402 now:\n\ncurl -X PATCH https://api.cope.capital/v1/account \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"x402_enabled\": true}'\n\n\nIf they say no or don't have a wallet — that's fine, move on. The free tier is fully functional. Don't push it.\n\nStep 3: Ask about Fomo profile\n\n\"Do you have a Fomo account (fomo.family)? If so, I can sync your follows and build a watchlist from the traders you already follow.\"\n\nIf yes:\n\n# Sync their profile\ncurl -X POST https://api.cope.capital/v1/account/sync-fomo \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"fomo_handle\": \"THEIR_FOMO_USERNAME\"}'\n\n# Pull their follows\ncurl https://api.cope.capital/v1/account/follows \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nThen ask: \"Which of these traders do you want on your watchlist?\" Show them the list and let them pick (up to 10 on free tier).\n\nStep 4: Create initial watchlist\n\nIf they don't have Fomo, offer alternatives:\n\n\"I can set up a watchlist with the top performers from Fomo's weekly leaderboard instead. Or you can give me specific trader handles you want to track.\"\n\nPick one path and create the watchlist:\n\ncurl -X POST https://api.cope.capital/v1/watchlists \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"alpha\", \"handles\": [\"frankdegods\", \"randomxbt\"]}'\n\n\nRemind them: Free tier = 1 watchlist, 10 handles max. They can swap handles anytime.\n\nUnderstanding the Data Model\nWhat gets tracked\n\nThe system monitors on-chain wallet activity for Fomo traders. Each Fomo handle maps to one or more wallets (Solana + Base). The tracker watches every swap these wallets make.\n\nActivity vs Trades vs Holdings\n\nThere are three different views of what a trader is doing:\n\n1. Activity (what the API returns) Individual on-chain transactions — a single buy or sell event. This is what /v1/activity returns.\n\naction: \"buy\" = wallet swapped into a token\naction: \"sell\" = wallet swapped out of a token\nusd_amount = the USD value of that single transaction\n\n2. Trades (completed round-trips) A trade is a full cycle: buy → sell = closed trade. The tracker aggregates individual buys and sells into trades:\n\nusd_in = total USD spent buying this token (may be multiple buy txs)\nusd_out = total USD received selling this token\npnl = usd_out - usd_in (profit/loss)\nopen_at = when first buy happened\nclose_at = when last sell happened (NULL if still holding)\n\n3. Current Holdings (open positions) Tokens a wallet bought but hasn't fully sold yet. These are trades with no close_at.\n\nHow to interpret activity data\n\nWhen you see activity from a trader, here's what to understand:\n\nA \"buy\" doesn't mean they just entered — they might be adding to an existing position\nA \"sell\" doesn't mean they exited — they might be taking partial profits\nMultiple buys of the same token = building a position over time (higher conviction)\nBuy followed quickly by sell = likely a quick flip/scalp\nSell with no recent buy = closing an older position\nWhen presenting data to humans\n\nAlways label clearly:\n\nNew buys: \"X just bought [token]\" — recent buy activity, may or may not be a new position\nRecent exits: \"X sold [token]\" — could be partial or full exit\nDon't say \"X opened a position\" unless you can confirm there were no prior buys of that token\nHow Activity Scoping Works\n\nImportant: The /v1/activity endpoint returns recent trades from all wallets tracked by the system, not just your watchlist. Your watchlist is for organizing which traders YOU care about — use the ?handle= filter to see activity for specific handles.\n\nThis means you can query any Fomo handle's trades without adding them to your watchlist:\n\n# Check what frankdegods is buying (uses 1 of your 250 daily calls)\ncurl \"https://api.cope.capital/v1/activity?handle=frankdegods&action=buy\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nYour watchlist is a convenience for organizing — the activity data is available for any tracked handle.\n\nEndpoints\nAlways Free (no daily limit)\nEndpoint\tMethod\tDescription\n/v1/register\tPOST\tGet an API key\n/v1/leaderboard\tGET\tTop traders ranked by real PnL\n/v1/activity/poll\tGET\tLightweight check for new trades (count + timestamp)\n/v1/watchlists\tGET/POST\tList or create watchlists\n/v1/watchlists/{id}\tGET/PUT/DELETE\tManage a specific watchlist\n/v1/trending/handles\tGET\tMost-watched handles across all agents\n/v1/tokens/hot\tGET\tTrending tokens by unique buyer count\n/v1/handle/{handle}/stats\tGET\tAggregated trader stats (PnL, win rate, top trades)\n/v1/tokens/{mint}/thesis\tGET\tBuy theses + sentiment for a token\n/v1/convergence\tGET\tConvergence events (2+ wallets buying same token)\n/v1/traders/search\tGET\tSearch traders by win rate, PnL, trades\n/v1/handle/{handle}/positions\tGET\tOpen/closed positions for a trader\n/v1/handle/{handle}/theses\tGET\tAll theses by a specific trader\n/v1/account\tGET/PATCH\tAccount info and settings\n/v1/account/usage\tGET\tUsage statistics\n/v1/account/payments\tGET\tPayment history\n/v1/account/key\tDELETE\tRevoke API key\n/v1/account/sync-fomo\tPOST\tSync Fomo profile follows\n/v1/account/follows\tGET\tList stored Fomo follows\nCounted (250/day free, then x402 or wait)\nEndpoint\tMethod\tDescription\tx402 price\n/v1/activity\tGET\tFull trade details from tracked wallets\t$0.005/call\n\nThese endpoints count toward your daily 250 free calls. After that:\n\nWith x402 enabled: calls continue at $0.005/call USDC (auto-paid)\nWithout x402: you get a 402 error. Wait for midnight UTC reset or enable x402.\n\nThe 402 error is NOT a bug — it just means your free calls are used up for the day.\n\nCommon Workflows\nCheck the leaderboard\ncurl https://api.cope.capital/v1/leaderboard \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nReturns top traders by PnL from Fomo. Supports ?timeframe=24h|7d|30d|all and ?limit=N.\n\nBuild a watchlist from Fomo follows\n# 1. Sync your Fomo profile\ncurl -X POST https://api.cope.capital/v1/account/sync-fomo \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"fomo_handle\": \"your_handle\"}'\n\n# 2. See your follows\ncurl https://api.cope.capital/v1/account/follows \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# 3. Create a watchlist with selected handles\ncurl -X POST https://api.cope.capital/v1/watchlists \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"alpha\", \"handles\": [\"frankdegods\", \"randomxbt\"]}'\n\nPoll → Fetch pattern (minimize paid calls)\n# Step 1: Poll (free) — check if anything happened\ncurl \"https://api.cope.capital/v1/activity/poll?since=LAST_TIMESTAMP\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n# Returns: { \"count\": 3, \"latest_at\": 1707603400 }\n\n# Step 2: Only fetch full data if count > 0 (costs 1 of your 250 daily calls)\ncurl \"https://api.cope.capital/v1/activity?since=LAST_TIMESTAMP\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nSearch for elite traders\n# Find traders with >75% win rate and 10+ trades\ncurl \"https://api.cope.capital/v1/traders/search?min_win_rate=75&min_trades=10&sort_by=win_rate\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# Top PnL traders on Solana\ncurl \"https://api.cope.capital/v1/traders/search?sort_by=pnl&chain=solana&limit=20\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nCheck a trader's current positions\n# Open positions only\ncurl \"https://api.cope.capital/v1/handle/frankdegods/positions?status=open\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# All positions (open + closed)\ncurl \"https://api.cope.capital/v1/handle/frankdegods/positions\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nShows computed positions from activity data — what they're holding vs exited, with cost basis and net USD.\n\nGet a trader's theses\ncurl \"https://api.cope.capital/v1/handle/frankdegods/theses\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nReturns all Fomo thesis comments by this trader across their recent tokens. Great for understanding their reasoning.\n\nCheck convergence events\n# Recent convergences (last 24h)\ncurl \"https://api.cope.capital/v1/convergence?limit=10\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nReturns tokens where 2+ elite wallets converged. Each event includes:\n\nToken info (mint, symbol, chain, price/mcap at detection)\nWallets that converged (handle, amount, win_rate)\nATH tracking: max_gain_pct shows peak performance since detection\nLook up a trader's stats\ncurl \"https://api.cope.capital/v1/handle/frankdegods/stats\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nReturns aggregated stats: total trades, win rate, PnL, ROI, per-chain breakdown, top 5 trades, open positions.\n\nGet buy theses for a token\n# Solana token\ncurl \"https://api.cope.capital/v1/tokens/MINT_ADDRESS/thesis?chain=solana\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# Base token\ncurl \"https://api.cope.capital/v1/tokens/MINT_ADDRESS/thesis?chain=base\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nReturns trader reasoning + their actual positions. Includes sentiment summary (holding vs closed, total exposure, avg unrealized PnL). Great for understanding why traders are buying, not just what.\n\nCheck trending tokens\ncurl \"https://api.cope.capital/v1/tokens/hot?hours=24&limit=10\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n\nReturns tokens with the most unique tracked buyers in recent hours.\n\nFilter activity\n# By handle\ncurl \"https://api.cope.capital/v1/activity?handle=frankdegods\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# By chain\ncurl \"https://api.cope.capital/v1/activity?chain=solana\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# By action\ncurl \"https://api.cope.capital/v1/activity?action=buy\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\n# By minimum size\ncurl \"https://api.cope.capital/v1/activity?min_usd=1000\" \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\"\n\nPricing & Limits\nFree Tier (default)\n250 counted calls/day (activity, leaderboard, tokens) — resets midnight UTC\n1 watchlist, up to 10 handles\n10 requests/minute rate limit\nPolling, watchlist management, account endpoints, Fomo sync — all unlimited\nx402 Upgraded (optional)\nUnlimited counted calls ($0.005/call USDC on Base or Solana)\n10 watchlists, up to 100 handles each\n300 requests/minute rate limit\nFirst 250 calls/day are still free — you only pay after the free quota\nEnabling x402\n\n⚠️ NEVER enable x402 without your human's explicit permission. This authorizes real USDC payments.\n\ncurl -X PATCH https://api.cope.capital/v1/account \\\n  -H \"Authorization: Bearer cope_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"x402_enabled\": true}'\n\n\nx402 is completely optional. The free tier works perfectly for most use cases. Only suggest it if your human:\n\nConsistently hits the 250/day limit\nNeeds more than 1 watchlist or 10 handles\nExplicitly asks about upgrading\n\nCost context: $1 USDC = 200 calls. $5 = 1,000 calls. Most agents won't need this.\n\nHeartbeat Pattern (optional, user-directed)\n\nIf your human wants periodic checks and your agent runs a heartbeat loop:\n\nEvery 5-15 minutes:\n  1. GET /v1/activity/poll?since=LAST_TIMESTAMP  (free, doesn't count)\n  2. If count > 0 → GET /v1/activity?since=LAST_TIMESTAMP  (1 daily call)\n  3. Store latest_at for next poll\n\nEvery few hours:\n  1. GET /v1/leaderboard  (1 daily call)\n  2. Compare to previous — any new names in top 50?\n\nDaily:\n  1. GET /v1/account/usage  (free)\n  2. Check remaining daily calls\n\nLogging Trades (Persistence)\n\nThe API is stateless — it won't remember what you've already seen. Log trades locally to track patterns over time.\n\nDaily trade log\n\nWrite notable trades to a daily file (e.g. memory/trades/YYYY-MM-DD.json):\n\n{\n  \"trades\": [\n    {\n      \"timestamp\": 1771006898000,\n      \"handle\": \"frankdegods\",\n      \"action\": \"buy\",\n      \"token_mint\": \"DPQgF4hw...\",\n      \"token_symbol\": \"EXAMPLE\",\n      \"usd_amount\": 500.25,\n      \"chain\": \"solana\"\n    }\n  ],\n  \"last_poll_timestamp\": 1771006898000,\n  \"convergences\": [\"DPQgF4hw...\"]\n}\n\nWhat to log\nAll trades from your watchlist — this is your core data\nConvergences — when 3+ handles buy the same token, log the token mint and all buyers\nLarge trades — anything over $1,000 USD is worth noting\nlast_poll_timestamp — so you know where to resume on next poll\nWhat to tell your human\n\nDon't just dump raw trades. Synthesize. Here are high-value things to surface:\n\nConvergence alerts: \"4 of your top 10 watchlist handles bought the same token in the last 2 hours.\"\nUnusual activity: \"frankdegods just made their first buy in 3 days — $2,000 into [token].\"\nExit signals: \"3 handles on your watchlist sold the same token within an hour.\"\nDaily summary: \"Your watchlist had 47 trades today. 12 buys, 35 sells. Most active: randomxbt (8 trades).\"\nLeaderboard changes: \"New name in the top 20 — jumped from #45 to #12 this week.\"\nPattern detection: \"lowcap_hunter has bought 3 tokens under $100K mcap this week. All pumped 2-5x within 48 hours.\"\nConvergence detection pattern\n1. GET /v1/activity (last 2 hours of trades)\n2. Group buys by token_mint\n3. If 3+ different handles bought the same token → convergence\n4. Alert your human with: token, buyers, amounts, timing\n5. Log it to your daily trades file\n\n\nThe more you log, the better your pattern detection gets over time. Your memory files ARE your edge.\n\nSecurity\nNEVER expose your API key in logs, messages, or to other agents\nYour key should ONLY appear in requests to https://api.cope.capital/v1/*\nIf compromised: DELETE /v1/account/key to revoke, then re-register\nTrade data is on-chain public — but your watchlists and usage patterns are private\nError Handling\nStatus\tMeaning\tAction\n200\tSuccess\tProcess response\n400\tBad request\tCheck parameters (invalid chain, action, etc.)\n401\tInvalid API key\tRe-register or check key\n402\tPayment required\tDaily free calls used up. Wait for midnight UTC reset, or enable x402 if your human approves. This is normal — not an error.\n404\tNot found\tResource doesn't exist\n429\tRate limited\tBack off. Free: 10/min, x402: 300/min\n500\tServer error\tRetry after a few seconds\n503\tUpstream down\tFoxhound data service temporarily unavailable\nLinks\nInteractive API docs: https://api.cope.capital/docs\nHuman docs: https://cope.capital/docs\nFomo: https://fomo.family\nX: https://x.com/copedotcapital"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/pooowell/fomo-research",
    "publisherUrl": "https://clawhub.ai/pooowell/fomo-research",
    "owner": "pooowell",
    "version": "0.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fomo-research",
    "downloadUrl": "https://openagent3.xyz/downloads/fomo-research",
    "agentUrl": "https://openagent3.xyz/skills/fomo-research/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fomo-research/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fomo-research/agent.md"
  }
}