Skip to main content
Clicker is modular. You don’t need to adopt everything at once. You might start with just leaderboards, or just trade comments appended to your existing notification system. The experience gets better the more of the stack you use, but each piece can deliver standalone value.

​
Trade Comments vs Trades

​
What is a Trade?

A trade is any onchain transaction where someone buys or sells a token. Clicker indexes trades from tracked wallets and can notify your app when they happen. You can also use your own internal trade indexing and just layer Clicker’s social data on top.

​
What is a Trade Comment?

A trade comment is when a trader attaches commentary explaining their trade. Not every trade has a comment. Each trade can have at most one comment. A trade comment provides context about why the trader is buying or selling - their thesis, conviction level, technical read, or any other reasoning they want to share.

​
Why This Distinction Matters

This distinction determines whether Comment Rewards apply:
  • When a user copies a trade comment, your trade fee is split between you, Clicker, and the comment author.
  • When a user copies a standard trade and trade notification that has no comment, you keep 100% of your trade fees.

​
Concrete Scenarios

Scenario A: Trade without comment. A user sees in their feed that a trader they follow just bought a token. There’s no comment attached. If the user buys the same token, it’s inspired by trade but does not qualify for Comment Rewards. You keep 100% of your fees. Scenario B: Trade with comment leading to copytrade. A user receives a notification: “Trader you follow just bought $WIF and wrote: ‘Buying because the team announced a partnership yesterday. Chart is forming a cup and handle pattern. Conviction: high.’” The user clicks the notification, reviews the comment, then buys $WIF. This IS a comment copytrade. Comment Rewards apply. Scenario C: Position visible on a profile, no comment. A user browses a leaderboard, clicks on a top trader’s profile, and sees that the trader has a new $WIF position but there’s no comment attached. If the user buys $WIF, it’s NOT a comment copytrade because no comment was involved. You keep 100% of fees. Scenario D: Comment on a position, viewed and acted on. A user browses a leaderboard, clicks on a top trader’s profile, and sees their open positions. One position has an attached comment explaining their thesis. The user reads the comment, is convinced, and buys $WIF. This IS a comment copytrade because the user engaged with the comment before trading. Comment Rewards apply.

​
Profiles & the Clicker Network

A Clicker profile represents a trader and aggregates their identity and trading activity.

​
Profile Structure

A profile consists of:
  • Linked Socials and Namespaces: ENS names, Solana names (.sol), Twitter/X accounts, Farcaster accounts, or other verified identity namespaces
  • Aggregated Addresses: All trading addresses controlled by the same trader across different blockchains and apps
  • Performance Metrics: PnL calculations, win rates, trade frequency
  • Positions: Open and closed positions across all linked addresses
  • Trade Comments: If a position has a comment, the comment is visible on that position - whether open or closed

​
How We Create Trader Profiles

Traders enter the Clicker network through two paths: 1. Direct Clicker onboarding. A trader signs up for Clicker and verifies their trading addresses across the apps they use. From there, whenever they trade on any platform, Clicker detects the trade and can prompt the trader to add a comment. This is how Clicker captures trade comments from traders across any platform - not just inside your app or a partner app. The trader comments in Clicker, and that comment flows out to every app in the network. 2. Partner app profile integration. Your app can push user profile data to Clicker. When you push a username and profile picture for a user who opts in, they appear across the entire Clicker network with a namespaced identifier: username.yourapp.xyz. They become discoverable on leaderboards and in search, and their positions and comments are visible network-wide.

​
Named vs Unnamed

A core principle of Clicker is that people want to follow people, not addresses. Throughout the Clicker experience, we default towards named traders and profiles. Addresses can be named even with anonymous names - an ENS name or a .sol domain still makes a raw address more usable. Leaderboards surface named accounts by default. Open and closed positions on token screens only show named traders - another strong surface area for discovery.

​
Profile Data Accessible via API

You can retrieve the following profile data through Clicker’s API: name and display info, linked social accounts, PnL metrics, win rate, open and closed positions with PnL and trade comments, all linked trading addresses, and follower/following counts.

​
The Social Graph

Following a trader adds that trader’s trades to a user’s feed and webhook notifications.

​
How Following Works

Users follow traders through the API by calling the follow endpoint with the follower’s address or profile ID and the target trader’s address or profile ID. This creates a directed relationship: User A now follows Trader B.

​
Why the Social Graph Matters

Dropping your users’ follow graph into Clicker is what powers two key features:
  1. Feed building. Clicker uses follow relationships to curate each user’s feed with relevant trades and comments from traders they care about.
  2. Webhooks. When a trader that one of your users follows makes a trade or comments on a trade, Clicker fires a webhook to your app so you can notify the user.

​
Siloed Social Graphs

Each app maintains its own isolated social graph. If a user follows a trader through your app, that follow relationship only exists in your context. If the same user also uses another Clicker-powered app, they would need to follow the same trader again there. This is the best of both worlds for you and your users. Your users’ follow graph isn’t portable to other apps, which gives you higher retention and stickiness. But your users can gain followers from other apps in the network, giving them more reach and more Comment Rewards. You get stickiness, your users get distribution.

​
Discovering Traders

Clicker provides multiple pathways for users to discover traders: Leaderboards. Traders are ranked by PnL. Leaderboards can be filtered by chain (Ethereum, Base, Solana, etc.). You can show “All Traders” or filter to “Commenters” only, surfacing traders who actively share their reasoning. Feed and Recommendations. Clicker can generate “For You” feed recommendations based on a user’s follow graph and what’s trending and interesting onchain. Token Positions. For any token, we return the largest open positions and highest PnL closed positions from named traders. When a user is browsing a specific token, they can see which traders have conviction in it. For example, a user researching $WIF sees that one trader has a $500K open position with 400% unrealized PnL, another has a $120K closed position with 250% realized PnL. The user can follow these traders, read their comments, and monitor their activity.

​
Copytrade Attribution

Copytrade attribution is Clicker’s mechanism for linking a user’s copytrade to a specific comment, enabling Comment Rewards for the comment author.

​
The Copytrade Flow

The complete flow for a valid copytrade:
  1. User engages with a comment. The user interacts with a trade comment in some context - clicking a comment notification, viewing a comment in their feed, reading a comment on a trader’s profile.
  2. User initiates a trade. The user decides to trade the same token and navigates to your trading UI.
  3. Your app modifies the fee recipient. Your app calls the DEX aggregator (0x, OKX, 1inch, etc.) but changes the fee recipient parameter from your own address to Clicker’s fee collection address.
  4. Your app fires a copy-intent. Before the user submits the transaction, your app makes a POST request to /copy-intent with the user’s address, the token being purchased, and the comment ID being attributed.
  5. User executes the transaction. The transaction hits the chain with the fee recipient set to Clicker’s address.
  6. Clicker validates it. Clicker monitors for the transaction and validates it against the copy-intent.
  7. Copytrade is recorded. If valid, the trade is recorded as a copytrade and attributed to the comment. Payouts to you, the comment author, and Clicker are scheduled for that day.

​
When Copytrades Apply

  • User receives a comment notification, clicks through, and buys = copytrade
  • User sees a comment in their feed or activity tracker, navigates to the token, and buys = copytrade
  • User visits a trader’s profile, reads a comment on a position, clicks through and buys = copytrade

​
When Copytrades Do NOT Apply

  • User sees trade activity (no comment) in a feed or on a leaderboard and buys = NOT a copytrade
  • User gets a trade notification (not a comment) and buys = NOT a copytrade
  • User sees a comment but buys the token days later by searching without any further engagement with the comment = NOT a copytrade
  • User copies a trade without engaging with any comment = NOT a copytrade

​
Attribution Window

There must be a reasonable timeframe between the user engaging with the comment and executing the trade. The typical window is within one hour of engagement. You and Clicker define this together during integration based on your app’s UX patterns.

​
Implementation Requirements

To implement copytrades, you need to:
  1. Monitor comment attribution Know when the user engaged with the comment so the fee recipient change happens afterwards.
  2. Have DEX aggregator parameter control. Ensure you can pass a custom fee recipient address to your DEX aggregator API.
  3. Coordinate with Clicker. Tell Clicker the address we should send your share of fees back to.

​
Comment Rewards & Settlement

Comment Rewards are the revenue mechanism that aligns Clicker with your app and rewards comment authors for their valuable content. Everyone wins: you get net new revenue from content that keeps users engaged in your app, comment authors earn from sharing useful analysis, and Clicker earns from facilitating it.

​
When Comment Rewards Apply

Comment Rewards apply ONLY to comment copytrades - trades directly driven by a comment interaction. All other activity has zero revenue split:
  • Leaderboard browsing and discovery: you keep 100% of fees
  • Trade notifications: you keep 100% of fees
  • Profile viewing: you keep 100% of fees
  • Regular positions with no comment engagement: you keep 100% of fees
You’re not paying Clicker for access to data or leaderboards. You only share revenue when Clicker’s comment content directly drives a user to trade - net new revenue you wouldn’t have captured otherwise.

​
How It Works Mechanically

You already integrate with DEX aggregators as part of your normal trading flow. These aggregators accept a fee recipient parameter. The integration requires no new infrastructure, no new smart contracts, and no routing changes. For non-comment trades: You call the DEX aggregator with the fee recipient set to your own address. You receive 100% of fees. For comment copytrades: You change the fee recipient parameter to Clicker’s fee collection address instead. Clicker then splits the fees. Different DEX aggregators use different parameter names:
  • 0x Protocol: swapFeeRecipient
  • OKX DEX API: fromTokenReferrerWalletAddress or toTokenReferrerWalletAddress
  • 1inch: referrer and referrerFee
The key point: these are standard parameters. You’re only changing who receives the fees on comment-driven trades.

​
Revenue Split

The revenue split on copytrades:
  • A share to you (the trading app where the comment copytrade happened)
  • A share to Clicker
  • 15% to the comment author (the trader who wrote the comment)

​
Settlement

Clicker settles Comment Rewards daily in USDC. Your share is sent to the wallet address registered with your partner account with us.

​
How Everyone Wins

  • You get content that keeps users in your app. Instead of discovering alpha elsewhere and potentially trading elsewhere, your users find compelling trade comments in your app and decide to act right there. Comment-driven trades are net new revenue.
  • Comment authors earn from sharing useful analysis. A share of copytrade fees on their comments creates a real incentive to write thoughtful, high-quality commentary. Authors earn when they drive revenue for you.
  • Clicker earns from facilitating the network. We invest in growing the commenter base, improving comment quality, and expanding the network because that’s how we earn.

​
Summary

These five core concepts form the foundation of how Clicker works:
  1. Trade Comments vs Trades. Only comment copytrades (comment-driven trades) trigger Comment Rewards. Regular trade activity and notifications are free for you to use however you want.
  2. Profiles & Network. Clicker is a named social network where traders build reputations, link identities, and become discoverable across apps. You can push your users’ profiles into the network.
  3. Social Graph. Users follow traders and discover new ones through leaderboards, feeds, and token position endpoints. Your social graph is siloed to your app, giving you retention advantages.
  4. Comment Copytrade Attribution. When a user engages with a comment and trades, Clicker attributes the trade to that comment by changing the fee recipient at the DEX aggregator level.
  5. Comment Rewards & Settlement. Only comment copytrades trigger revenue sharing. You change one parameter in your DEX aggregator call. Clicker settles your share daily in USDC. We only earn when we drive net new revenue for you.