# Clicker - Feed API

## Docs

- [What is Clicker?](https://docs.clicker.xyz/guides/what-is-clicker.md): The cross-app social network for traders
- [Core Concepts](https://docs.clicker.xyz/guides/core-concepts.md): How Clicker works
- [Integration Guide](https://docs.clicker.xyz/guides/integration-guide.md): How to implement Clicker features in your app
- [External IDs](https://docs.clicker.xyz/guides/external-ids.md): Use your own user IDs to manage follows and webhooks without requiring wallet addresses
- [PnL in Your App](https://docs.clicker.xyz/guides/pnl-overview.md)
- [How We Compute PnL](https://docs.clicker.xyz/guides/pnl-system.md)
- [PnL Data Integrity](https://docs.clicker.xyz/guides/pnl-integrity.md)
- [Position Calculations](https://docs.clicker.xyz/guides/position-calculations.md): How to calculate current value, unrealized PnL, and percent change
- [Perps Positions](https://docs.clicker.xyz/guides/perps.md): How do use perps returned by the Clicker API
- [Comment Moderation](https://docs.clicker.xyz/guides/comment-moderation.md)
- [FAQ](https://docs.clicker.xyz/guides/faq.md): Frequently asked questions about Clicker
- [Request API Key](https://docs.clicker.xyz/about/request-api-key.md)
- [About Profiles](https://docs.clicker.xyz/about/profiles.md): How we assign addresses to people
- [Profile](https://docs.clicker.xyz/api-reference/profile.md): Returns the profile (name, addresses, images, and metadata) for a given address or profile UUID.
- [Address Follows](https://docs.clicker.xyz/api-reference/profile-follows.md): Return a list of the profiles that the given address follows.
- [Address Followers](https://docs.clicker.xyz/api-reference/profile-followers.md): Return a list of the profiles who follow the given address.
- [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…
- [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…
- [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.
- [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.
- [Profile Name](https://docs.clicker.xyz/api-reference/profile-delete-name.md): Deletes the name and avatar for this profile.
- [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.
- [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.
- [Profile Positions](https://docs.clicker.xyz/api-reference/profile-positions.md): Returns token positions for a profile containing full trade history.
- [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.
- [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.
- [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.
- [Post Comment](https://docs.clicker.xyz/api-reference/post-comment.md): Creates a new comment on a swap transaction.
- [Token Comments](https://docs.clicker.xyz/api-reference/token-comments.md)
- [Retrieve Comments](https://docs.clicker.xyz/api-reference/retrieve-comment.md): Retrieves all comments for specific swaps.
- [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.)
- [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
- [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.
- [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:
- [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.
- [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…
- [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.
- [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.
- [Profile](https://docs.clicker.xyz/response-types/profile-extended.md)
- [ProfileWithMetrics](https://docs.clicker.xyz/response-types/profile-with-metrics.md)
- [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)
- [Trader](https://docs.clicker.xyz/response-types/trader-v2.md)
- [Leaderboard](https://docs.clicker.xyz/response-types/leaderboard-v2-response.md)
- [SwapComment](https://docs.clicker.xyz/response-types/swap-comment-response.md)
- [WebhookConfig](https://docs.clicker.xyz/response-types/webhook-response.md)

## OpenAPI Specs

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.