Fomo Research

Smart money intelligence for AI agents. Powered by fomo.family social graph, built by cope.capital.

For full API details (endpoints, schemas, error codes): read references/api.md.

Base URL

https://api.cope.capital

All requests require Authorization: Bearer cope_<key> header.

First-Run Onboarding

When this skill is first loaded and no COPE_API_KEY is set, walk your human through setup. Ask these questions in order:

Step 1: Register

curl -X POST https://api.cope.capital/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "YOUR_AGENT_NAME", "description": "optional description"}'

Save the api_key from the response (starts with cope_). This is your COPE_API_KEY. Store it securely — treat it like a password.

Step 2: Ask about crypto wallet (optional)

Before continuing, ask your human:

"Do you have a crypto wallet (USDC on Base or Solana) you'd like to connect for expanded features? Without one you get:

• 1 watchlist with up to 10 handles
• 250 activity lookups per day (resets midnight UTC)
• Everything else (leaderboard, trending, polling) is unlimited and free

With 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."

If they want to set up x402 now:

curl -X PATCH https://api.cope.capital/v1/account \
  -H "Authorization: Bearer cope_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x402_enabled": true}'

If they say no or don't have a wallet — that's fine, move on. The free tier is fully functional. Don't push it.

Step 3: Ask about Fomo profile

"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."

If yes:

# Sync their profile
curl -X POST https://api.cope.capital/v1/account/sync-fomo \
  -H "Authorization: Bearer cope_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fomo_handle": "THEIR_FOMO_USERNAME"}'

# Pull their follows
curl https://api.cope.capital/v1/account/follows \
  -H "Authorization: Bearer cope_YOUR_KEY"

Then 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).

Step 4: Create initial watchlist

If they don't have Fomo, offer alternatives:

"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."

Pick one path and create the watchlist:

curl -X POST https://api.cope.capital/v1/watchlists \
  -H "Authorization: Bearer cope_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "alpha", "handles": ["frankdegods", "randomxbt"]}'

Remind them: Free tier = 1 watchlist, 10 handles max. They can swap handles anytime.