​

The Integration Spectrum

Clicker is modular. You can integrate as much or as little as you want. You could build entirely your own social trading features - your own leaderboard, your own trade notifications, your own wallet tracking - and just use Clicker for trade comments. That works. Our goal is to provide you the best trade comments for your users, and to let your users comment on their trades and earn from them across the Clicker network. Our PnL, leaderboard, and social trading APIs exist so that you don’t have to build all of that internally, since we’ve already done the work. But they’re optional. Use what you need, skip what you don’t.

​

Leaderboard

The leaderboard ranks traders by PnL across different blockchains.

​

What you’re building

A leaderboard tab or section in your app where users can discover top traders, see their performance, and follow them. This is the lowest-friction starting point - no webhooks, no user authentication needed.

​

How to implement

Fetch leaderboard data from Clicker’s leaderboard endpoint with chain filters (Solana, Base, Ethereum, etc.). Provide tab switching between “All Traders” and “Commenters” - the commenters tab surfaces traders who actively explain their trades, which is higher signal. For each trader, pull their profile data to display: name, avatar, verified socials (Twitter/X, ENS, Farcaster), and PnL. Add a follow button next to each trader that calls the follow endpoint.

​

Token page enrichment

On any token detail page, call the token positions endpoint. This returns the largest open positions and highest PnL closed positions in that token from named traders. The value here is discovery: your users find the best traders on tokens they already care about. When they follow those traders, they start getting relevant trade and trade comment notifications in your app, which drives engagement and keeps users coming back.

​

Trade Notifications

Real-time alerts when traders your users follow make trades.

​

What you’re building

Webhook-driven notifications that let your users know when followed traders are active. If you already have your own trade tracking and notification system, you can skip Clicker’s webhooks and just append trade comments (see next section) to your own notifications.

​

How to implement

Register a webhook endpoint with Clicker. When a followed trader makes a trade, Clicker sends a POST request to your endpoint with the trade details.

​

Position context

When users open a trade or trade comment notification, land them on a position screen for that trader and token. The position screen shows entry price, current price, unrealized PnL, position size, and whether the trader is still holding or has already exited. This gives the user context to decide - not just a raw buy screen or token screen.

​

Trade Comments

Trade comments are the core of Clicker. A trade comment is when a trader explains why they made a trade - their thesis, conviction, analysis.

​

What you’re building

Surfacing trade comments from the Clicker network in your app, and letting your own users write comments on their trades.

​

Where to surface comments

Comments can appear in several places in your app:

• Notifications - when a followed trader comments on a trade, include the comment in the notification
• Feed items - comments displayed in a social feed or activity feed
• Positions on profiles - when viewing a trader’s profile, comments are visible on their open and closed positions
• Positions on token screens - when viewing a specific token, trader positions with comments show the comment
• Full position screen - when viewing a specific trader’s position in detail, the comment is front and center

Comments are higher signal than raw trade notifications because they explain the reasoning. Distinguish comment notifications visually from trade-only notifications.

​

Letting your users comment

Provide an in-app interface for users to add a comment after they execute a trade. Each trade can have at most one comment. Comments should be optional but encouraged. Once posted, the comment is visible across the entire Clicker network - on leaderboards, in other apps, wherever that trader’s positions appear. Your users earn Comment Rewards when other users copytrade based on their comments.

​

Copytrade Attribution

Copytrade attribution links a user’s trade to a specific comment, enabling Comment Rewards.

​

What you’re building

You’re not building the revenue split - Clicker handles that. The only change you make is swapping the fee payout address whenever a trade is driven by a comment. Clicker takes care of splitting revenue between you, the comment author, and Clicker from there.

​

How it works

1. A user engages with a trade comment - clicks a comment notification, views a comment in a feed, reads a comment on a trader’s profile, etc.
2. The user decides to buy the same token.
3. Before the transaction, your app fires a POST /copy-intent with the user’s address, the token, and the comment ID.
4. Your app calls the DEX aggregator but changes the fee recipient parameter from your address to Clicker’s fee collection address. The parameter name varies by aggregator:
   • 0x: swapFeeRecipient
   • OKX: fromTokenReferrerWalletAddress / toTokenReferrerWalletAddress
   • 1inch: referrer and referrerFee
5. The user executes the transaction.
6. Clicker validates it against the copy-intent.
7. If valid, the trade is recorded as a copytrade. Payouts to you, the comment author, and Clicker are scheduled for that day.

​

Revenue split

• A share to your app
• 15% to the comment author
• A share to Clicker

Settlement is daily in USDC.

​

What counts as a copytrade

• User gets a comment notification, clicks through, buys = copytrade
• User sees a comment in a feed, navigates to the token, buys = copytrade
• User reads a comment on a trader’s profile, clicks through, buys = copytrade

​

What does NOT count

• User sees trade activity (no comment) and buys = not a copytrade
• User gets a trade notification (not a comment notification) and buys = not a copytrade
• User sees a comment but buys the token days later without re-engaging with the comment = not a copytrade

​

User Profiles

Profiles let your users build reputation across the Clicker network.

​

What you’re building

A bridge that pushes your users’ identities into Clicker so they’re discoverable and can earn Comment Rewards.

​

How to implement

When a user opts in, push their username and profile picture to Clicker’s profile endpoint. They appear across the Clicker network as username.yourapp.xyz - discoverable on leaderboards, in search, and in other apps. Users who create profiles can comment on their trades and earn Comment Rewards. Their reputation compounds as they accumulate followers across apps. X/Twitter verification is available - reach out to discuss.