# Clicker - Feed API

## Docs

- [About Profiles](https://docs.clicker.xyz/about/profiles.md): How we assign addresses to people
- [Request API Key](https://docs.clicker.xyz/about/request-api-key.md)
- [Copyswap Intent](https://docs.clicker.xyz/api-reference/copy-intent.md): Fire this when a user moves to copytrade a comment. (For example: when a user taps a button on a comment to buy that token.)
- [Feed](https://docs.clicker.xyz/api-reference/feed.md): Given a list of addresses, return a feed of swaps made by profiles that those addresses follow. Returns swaps on Base, Ethereum, and Solana.
- [Feed, Specific Addresses](https://docs.clicker.xyz/api-reference/feed-actor.md): Given a profile ID, return a feed of swaps made by them. Returns swaps on Base, Ethereum, and Solana.
- [Follow Address](https://docs.clicker.xyz/api-reference/follow.md): For a given address, follow one or more target addresses. Following an address will automatically follow the whole profile and all their other addresses. The given address will then see those targets' activity in their feed. Note: For performance, returned profiles exclude social metrics (follower c…
- [Bulk Follow/Unfollow Addresses](https://docs.clicker.xyz/api-reference/follow-bulk.md): Bulk-add follow and unfollow relationships between addresses and their targets. Note: For performance, returned profiles exclude social metrics (follower counts, copytrade stats). Use the Get Profile endpoint for full metrics.
- [Leaderboard](https://docs.clicker.xyz/api-reference/leaderboard-v2.md): Get the top traders with combined PnL across selected chains. Returns a flat list of traders sorted by total PnL.
- [Leaderboard Ranking](https://docs.clicker.xyz/api-reference/leaderboard-v2-ranking.md): Get a specific user's ranking position based on combined PnL across selected chains.
- [Position by ID](https://docs.clicker.xyz/api-reference/position.md): Given a position ID, get a single position with its trades and comments.
- [Position by Details](https://docs.clicker.xyz/api-reference/position-by-timestamp.md): Find a position (actor address, chain, token address) by the UNIX timestamp. Can be used to find a position for a user's specific swap transaction.
- [Post Comment](https://docs.clicker.xyz/api-reference/post-comment.md): Creates a new comment on a swap transaction.
- [Profile](https://docs.clicker.xyz/api-reference/profile.md): Returns the profile (name, addresses, images, and metadata) for a given address or profile UUID.
- [Profile Name](https://docs.clicker.xyz/api-reference/profile-delete-name.md): Deletes the name and avatar for this profile.
- [Address Followers](https://docs.clicker.xyz/api-reference/profile-followers.md): Return a list of the profiles who follow the given address.
- [Address Follows](https://docs.clicker.xyz/api-reference/profile-follows.md): Return a list of the profiles that the given address follows.
- [Profile Positions](https://docs.clicker.xyz/api-reference/profile-positions.md): Returns token positions for a profile containing full trade history.
- [Profile Name](https://docs.clicker.xyz/api-reference/profile-set-name.md): Set a name and avatar for a profile, scoped to each partner. Your domain suffix (e.g. `.clicker.xyz`) is appended to the name in responses.
- [Retrieve Comments](https://docs.clicker.xyz/api-reference/retrieve-comment.md): Retrieves all comments for specific swaps.
- [Token Comments](https://docs.clicker.xyz/api-reference/token-comments.md)
- [Token Positions](https://docs.clicker.xyz/api-reference/token-positions.md): Returns positions for a specific token across all traders. Open positions are those with remaining value >= \$1; closed positions have remaining value < \$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.
- [Tokens Feed](https://docs.clicker.xyz/api-reference/tokens-feed.md): Returns a feed of tokens sorted by most recent comment. Each item contains the most recent comment (and associated trade metadata) per actor for that token within the past 7 days. Filter by chain using the `chains` query parameter.
- [Unfollow Address](https://docs.clicker.xyz/api-reference/unfollow.md): Remove one or more target addresses from the given address's follow list. Unfollowing an address will automatically unfollow other addresses belonging to that profile. Note: For performance, returned profiles exclude social metrics (follower counts, copytrade stats). Use the Get Profile endpoint for…
- [Verifying Webhooks](https://docs.clicker.xyz/api-reference/verifying-webhooks.md): When Clicker sends a webhook event to your server, a signature passed in the request headers allows you to verify it's authenticity. It's important that you verify that the header matches the HMAC signature of the request payload signed with your webhook secret to ensure the request originated from…
- [Registered Webhooks](https://docs.clicker.xyz/api-reference/webhook.md): Provides a list of all or your currently registered feed webhooks. Use this if you have lost the uid for a webhook you created.
- [Webhook Addresses](https://docs.clicker.xyz/api-reference/webhook-addresses.md): Provides a page of 1000 addresses subscibed to your feed webhook, with links to the next and prev pages if applicable.
- [Integration Guide](https://docs.clicker.xyz/api-reference/webhook-integration.md): Best practices for integrating trade and comment notifications with fatigue prevention
- [Webhook Payloads](https://docs.clicker.xyz/api-reference/webhook-payloads.md): Payload shapes for each webhook event type
- [Register Webhook](https://docs.clicker.xyz/api-reference/webhook-register.md): Register a new endpoint to receive webhook events containing feed items. This endpoint will respond with:
- [Update Webhook](https://docs.clicker.xyz/api-reference/webhook-update.md): Provide the UID you received when you created your webhook in order to modify it using this endpoint. Updatees include:           -Add or remove wallets who are subscribed to the webhook           -Replace the list of subscribers for the webhook entirely           -Modify the destination URL which t…
- [Validate Destination](https://docs.clicker.xyz/api-reference/webhook-validate.md): Validate and test the functionality of your receiving endpoing by calling this endoint. Upon receiving this POST, we will make two requests to the destination URL:             - one without a signature       - one with a valid "Daylight-Signature" header.
- [Comment Moderation](https://docs.clicker.xyz/guides/comment-moderation.md)
- [Core Concepts](https://docs.clicker.xyz/guides/core-concepts.md): How Clicker works
- [External IDs](https://docs.clicker.xyz/guides/external-ids.md): Use your own user IDs to manage follows and webhooks without requiring wallet addresses
- [FAQ](https://docs.clicker.xyz/guides/faq.md): Frequently asked questions about Clicker
- [Integration Guide](https://docs.clicker.xyz/guides/integration-guide.md): How to implement Clicker features in your app
- [Perps Positions](https://docs.clicker.xyz/guides/perps.md): How do use perps returned by the Clicker API
- [PnL Data Integrity](https://docs.clicker.xyz/guides/pnl-integrity.md)
- [PnL in Your App](https://docs.clicker.xyz/guides/pnl-overview.md)
- [How We Compute PnL](https://docs.clicker.xyz/guides/pnl-system.md)
- [Position Calculations](https://docs.clicker.xyz/guides/position-calculations.md): How to calculate current value, unrealized PnL, and percent change
- [What is Clicker?](https://docs.clicker.xyz/guides/what-is-clicker.md): The cross-app social network for traders
- [FeedActor](https://docs.clicker.xyz/response-types/feed-actor.md)
- [Feed](https://docs.clicker.xyz/response-types/feed-response.md)
- [HydratedPosition](https://docs.clicker.xyz/response-types/hydrated-position.md)
- [Leaderboard](https://docs.clicker.xyz/response-types/leaderboard-v2-response.md)
- [Profile](https://docs.clicker.xyz/response-types/profile-extended.md)
- [ProfileWithMetrics](https://docs.clicker.xyz/response-types/profile-with-metrics.md)
- [SwapComment](https://docs.clicker.xyz/response-types/swap-comment-response.md)
- [Trader](https://docs.clicker.xyz/response-types/trader-v2.md)
- [WebhookConfig](https://docs.clicker.xyz/response-types/webhook-response.md)
- [Signing Comments](https://docs.clicker.xyz/signing-comments.md): When a user creates a Swap Comment from a partner wallet, they also sign a message proving the comment is authentic.

## OpenAPI Specs

- [openapi](https://api.clicker.xyz/internal-documentation/openapi.json?v=1)