> ## Documentation Index > Fetch the complete documentation index at: https://docs.clicker.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Feed, Specific Addresses > Given a profile ID, return a feed of swaps made by them. Returns swaps on Base, Ethereum, and Solana. ## OpenAPI ````yaml GET /v1/feed/actor openapi: 3.0.0 info: version: 1.0.0 title: Daylight.xyz API description: >- Welcome to the Daylight API! API endpoints require a Daylight partner API key passed in the HTTP Authorization header. servers: - url: https://api.clicker.xyz security: - {} - bearerAuth: [] paths: /v1/feed/actor: get: tags: - Social - Feed, Profiles and Discovery summary: Get Feed for Profile description: >- Given a profile ID, return a feed of swaps made by them. Returns swaps on Base, Ethereum, and Solana. parameters: - schema: type: array items: type: string required: true name: addresses in: query - schema: type: string required: false name: olderThan in: query - schema: type: string required: false name: newerThan in: query - schema: type: boolean required: false name: onlyWithComments in: query - schema: type: array description: >- If included, only include transactions with actions on the provided chains. Defaults to `base`, `ethereum`, `solana`. Pass `all` to see transactions on all supported chains. items: enum: - ethereum - optimism - polygon - arbitrum - zora - base - zero - solana - hyperliquid - all readOnly: true required: false name: chains in: query - schema: type: number description: The total number of records to respond with. Defaults to 25. required: false name: limit in: query - schema: type: boolean description: >- When true, injects algorithmically-recommended For You trades into the feed as recommended content. required: false name: injectForYou in: query - schema: type: number description: >- Filter to trades with absolute USD value >= this amount. Allowed values: 10, 100, 500, 1000 required: false name: minTradeUsd in: query - schema: type: number description: >- Filter to trades with token market cap >= this amount. Allowed values: 100000, 1000000, 10000000 required: false name: minMarketCap in: query - schema: type: number description: >- Filter to trades with token market cap < this amount. Allowed values: 100000, 1000000, 10000000 required: false name: maxMarketCap in: query - schema: type: boolean required: false name: providedAddressesOnly in: query responses: '200': description: '200' content: application/json: schema: $ref: '#/components/schemas/FeedResponse' '400': description: >- The request payload or query string parameter you passed was not valid content: application/json: schema: type: object properties: error: type: string required: - error components: schemas: FeedResponse: type: object properties: items: type: array items: type: object properties: totalCompletions: type: number description: >- Number of unique addresses that purchased this token in the last 24 hours imageUrl: type: string description: Profile avatar image URL of the actor itemTitle: type: string description: Display title for the position (typically profile name) callToActions: type: array items: type: object properties: text: type: string url: type: string required: - text - url description: Action buttons/links for this position metadata: type: object properties: tokenChain: type: string enum: - ethereum - optimism - polygon - arbitrum - zora - base - zero - solana - hyperliquid description: Blockchain network (e.g., ethereum, solana, base) tokenSymbol: type: string description: Token ticker symbol tokenName: type: string description: Human-readable token name tokenAddress: type: string description: Contract address of the token metadataType: type: string enum: - token totalSupply: type: string nullable: true description: Total token supply if known perpPositionType: type: string nullable: true enum: - long - short description: >- For perp positions, whether this is a 'long' or 'short' position. Null for spot positions. perpLeverage: type: number nullable: true description: >- For perp positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot positions. positionAmount: type: number description: >- Current token balance held. A value >= 0.0001 indicates an open position; < 0.0001 indicates closed. For perps, this is the un-leveraged amount. positionAmountWithLeverage: type: number description: >- For leveraged perp positions, the position amount multiplied by leverage (capital at risk). Only present for hyperliquid. positionStats: type: object properties: boughtUSD: type: number description: >- Total USD spent buying this token (all-time). For perps, this is the un-leveraged amount. boughtUSDWithLeverage: type: number description: >- For leveraged perp positions, total USD spent multiplied by leverage. Only present for hyperliquid. soldUSD: type: number description: >- Total USD received from selling this token (all-time). For perps, this is the un-leveraged amount. soldUSDWithLeverage: type: number description: >- For leveraged perp positions, total USD received multiplied by leverage. Only present for hyperliquid. realizedGainsUSD: type: number description: >- Realized profit/loss in USD (sold value minus cost basis of sold tokens) holdingsCostBasisUSD: type: number description: >- USD cost basis of tokens currently held (for unrealized P&L calculation). For perps, this is the un-leveraged amount. holdingsCostBasisUSDWithLeverage: type: number description: >- For leveraged perp positions, cost basis of held tokens multiplied by leverage. Only present for hyperliquid. receivedCostBasisUSD: type: number description: >- Total USD value of tokens received via airdrops/transfers (all-time) holdingReceivedCostBasisUSD: type: number description: USD cost basis of currently held received tokens isOpen: type: boolean description: Whether this position is currently open unavailable: type: boolean enum: - true description: True when position metrics could not be computed required: - boughtUSD - soldUSD - realizedGainsUSD - holdingsCostBasisUSD - receivedCostBasisUSD - holdingReceivedCostBasisUSD - isOpen description: Aggregated trading statistics for this position trades: type: array items: type: object properties: tokenAmount: type: number description: The amount of tokens traded. Negative for sells. usdCost: type: number description: >- The USD cost traded for all tokens. Negative for sells. marketCap: type: number nullable: true description: >- The market cap of the token at the time of this trade timestamp: type: number transactionHash: type: string direction: type: string enum: - buy - sell classification: type: string nullable: true enum: - spot - perp - send - receive description: >- High-level trade classification: 'spot' for spot trades, 'perp' for perpetual futures, 'send' for outgoing transfers, 'receive' for airdrops/incoming transfers. Null for legacy trades. intent: type: string enum: - enter - exit description: >- Whether this trade is entering or exiting a position. For spot trades, 'enter' = buy and 'exit' = sell. For perps, direction depends on position type (e.g., opening a short is 'enter' even though the trade side is 'sell'). perpPositionType: type: string nullable: true enum: - long - short description: >- For perps positions, whether this is a 'long' or 'short' position. Null for spot trades. perpLeverage: type: number nullable: true description: >- For perps positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot trades. comments: type: array items: type: object properties: uid: type: string description: Unique identifier for the comment transactionHash: type: string description: The transaction hash associated with the swap chain: type: string enum: - ethereum - optimism - polygon - arbitrum - zora - base - zero - solana - hyperliquid tokenAddress: type: string description: The token address associated with the swap commentText: type: string description: The comment text signerAddress: type: string description: The Ethereum address of the comment author timestamp: type: number description: Unix timestamp of when the comment was created isAppUserComment: type: boolean description: >- Whether the comment was created by a user of this partner's app metrics: type: object properties: copyCount: type: number description: >- The number of times the comment has been copied copyVolume: type: string description: The volume of the comment in USD likeCount: type: number description: The number of likes on this comment isLikedByUser: type: boolean description: >- Whether the requesting user has liked this comment required: - copyCount - copyVolume - likeCount - isLikedByUser replies: type: array items: type: object properties: id: type: string description: Unique identifier for the reply text: type: string description: The reply text author: type: object properties: type: type: string enum: - user address: type: string name: type: string description: >- The name of the feed actor. Use this field for maximum forward compatibility. images: type: object properties: raw: type: string nullable: true description: The full-sized image xs: type: string nullable: true description: 75x75 sm: type: string nullable: true description: 300x300 required: - raw - xs - sm description: >- An image of the feed actor. Use this field for maximum forward compatibility. profile: type: object properties: id: type: string name: type: string images: type: object properties: raw: type: string nullable: true description: The full-sized image xs: type: string nullable: true description: 75x75 sm: type: string nullable: true description: 300x300 required: - raw - xs - sm description: URLs for different size squares. addresses: type: array items: type: string externalId: type: string metadata: type: object properties: farcasterUsername: type: string nullable: true farcasterId: type: number nullable: true lensHandle: type: string nullable: true ensName: type: string nullable: true twitterHandle: type: string nullable: true debankName: type: string nullable: true hlName: type: string nullable: true commentCount30d: type: number nullable: true pnl30d: type: number nullable: true winRate30d: type: number nullable: true tradeCount30d: type: number nullable: true roiPercent30d: type: number nullable: true pnl7d: type: number nullable: true winRate7d: type: number nullable: true tradeCount7d: type: number nullable: true roiPercent7d: type: number nullable: true medianHoldingTimeMinutes: type: number nullable: true required: - farcasterUsername - farcasterId - lensHandle - ensName - twitterHandle - debankName - hlName - commentCount30d - pnl30d - winRate30d - tradeCount30d - roiPercent30d - pnl7d - winRate7d - tradeCount7d - roiPercent7d - medianHoldingTimeMinutes isNSFW: anyOf: - type: boolean enum: - false - type: object properties: nsfwImage: type: boolean nsfwText: type: boolean required: - nsfwImage - nsfwText description: >- `false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content. required: - id - name - images - addresses - metadata - isNSFW description: >- Profile of the user (including additional known addresses and extra metadata). Use this field to tailor your UI specifically. required: - type - address - name - images - profile description: >- The actor that completed an action to create a feed item. timestamp: type: number description: >- Unix timestamp of when the reply was created likeCount: type: number description: The number of likes on this reply isLikedByUser: type: boolean description: >- Whether the requesting user has liked this reply required: - id - text - author - timestamp - likeCount - isLikedByUser description: >- Replies to this comment, only included when fetching a single position required: - uid - transactionHash - chain - tokenAddress - commentText - timestamp - isAppUserComment - metrics required: - tokenAmount - usdCost - marketCap - timestamp - transactionHash - direction - classification - intent - perpPositionType - perpLeverage - comments description: >- Complete list of all buy/sell transactions for this token by this actor, ordered by timestamp descending required: - tokenChain - tokenSymbol - tokenName - tokenAddress - metadataType - totalSupply - perpPositionType - perpLeverage - positionAmount - positionStats - trades description: Token details and position statistics including all trades insights: type: array items: type: object properties: text: type: string required: - text description: AI-generated insights and metrics about this position metrics: type: object properties: copyCount: type: number description: The number of times the comment has been copied copyVolume: type: string description: The volume of the comment in USD likeCount: type: number description: The number of likes on this comment isLikedByUser: type: boolean description: Whether the requesting user has liked this comment replyCount: type: number description: Number of replies on this position commentCount: type: number description: The number of author comments on this position required: - copyCount - copyVolume - likeCount - isLikedByUser - replyCount - commentCount description: >- Engagement metrics: copytrade count and volume, reply count, comment count itemId: type: string description: Unique identifier for this feed card (position) transactionHash: type: string description: Transaction hash of the most recent trade in this position timestamp: type: number description: Unix timestamp of the most recent trade in this position cardLatestTradeAt: type: number description: >- Unix timestamp of the most recent trade in this position. Used for "latest" sort ordering. actor: type: object properties: type: type: string enum: - user address: type: string name: type: string description: >- The name of the feed actor. Use this field for maximum forward compatibility. images: type: object properties: raw: type: string nullable: true description: The full-sized image xs: type: string nullable: true description: 75x75 sm: type: string nullable: true description: 300x300 required: - raw - xs - sm description: >- An image of the feed actor. Use this field for maximum forward compatibility. profile: type: object properties: id: type: string name: type: string images: type: object properties: raw: type: string nullable: true description: The full-sized image xs: type: string nullable: true description: 75x75 sm: type: string nullable: true description: 300x300 required: - raw - xs - sm description: URLs for different size squares. addresses: type: array items: type: string externalId: type: string metadata: type: object properties: farcasterUsername: type: string nullable: true farcasterId: type: number nullable: true lensHandle: type: string nullable: true ensName: type: string nullable: true twitterHandle: type: string nullable: true debankName: type: string nullable: true hlName: type: string nullable: true commentCount30d: type: number nullable: true pnl30d: type: number nullable: true winRate30d: type: number nullable: true tradeCount30d: type: number nullable: true roiPercent30d: type: number nullable: true pnl7d: type: number nullable: true winRate7d: type: number nullable: true tradeCount7d: type: number nullable: true roiPercent7d: type: number nullable: true medianHoldingTimeMinutes: type: number nullable: true required: - farcasterUsername - farcasterId - lensHandle - ensName - twitterHandle - debankName - hlName - commentCount30d - pnl30d - winRate30d - tradeCount30d - roiPercent30d - pnl7d - winRate7d - tradeCount7d - roiPercent7d - medianHoldingTimeMinutes isNSFW: anyOf: - type: boolean enum: - false - type: object properties: nsfwImage: type: boolean nsfwText: type: boolean required: - nsfwImage - nsfwText description: >- `false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content. required: - id - name - images - addresses - metadata - isNSFW description: >- Profile of the user (including additional known addresses and extra metadata). Use this field to tailor your UI specifically. required: - type - address - name - images - profile description: Profile information of the trader who holds/held this position forYouTrade: type: object properties: tokenAmount: type: number description: The amount of tokens traded. Negative for sells. usdCost: type: number description: The USD cost traded for all tokens. Negative for sells. marketCap: type: number nullable: true description: The market cap of the token at the time of this trade timestamp: type: number transactionHash: type: string direction: type: string enum: - buy - sell classification: type: string nullable: true enum: - spot - perp - send - receive description: >- High-level trade classification: 'spot' for spot trades, 'perp' for perpetual futures, 'send' for outgoing transfers, 'receive' for airdrops/incoming transfers. Null for legacy trades. intent: type: string enum: - enter - exit description: >- Whether this trade is entering or exiting a position. For spot trades, 'enter' = buy and 'exit' = sell. For perps, direction depends on position type (e.g., opening a short is 'enter' even though the trade side is 'sell'). perpPositionType: type: string nullable: true enum: - long - short description: >- For perps positions, whether this is a 'long' or 'short' position. Null for spot trades. perpLeverage: type: number nullable: true description: >- For perps positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot trades. comments: type: array items: type: object properties: uid: type: string description: Unique identifier for the comment transactionHash: type: string description: The transaction hash associated with the swap chain: type: string enum: - ethereum - optimism - polygon - arbitrum - zora - base - zero - solana - hyperliquid tokenAddress: type: string description: The token address associated with the swap commentText: type: string description: The comment text signerAddress: type: string description: The Ethereum address of the comment author timestamp: type: number description: Unix timestamp of when the comment was created isAppUserComment: type: boolean description: >- Whether the comment was created by a user of this partner's app metrics: type: object properties: copyCount: type: number description: The number of times the comment has been copied copyVolume: type: string description: The volume of the comment in USD likeCount: type: number description: The number of likes on this comment isLikedByUser: type: boolean description: >- Whether the requesting user has liked this comment required: - copyCount - copyVolume - likeCount - isLikedByUser replies: type: array items: type: object properties: id: type: string description: Unique identifier for the reply text: type: string description: The reply text author: type: object properties: type: type: string enum: - user address: type: string name: type: string description: >- The name of the feed actor. Use this field for maximum forward compatibility. images: type: object properties: raw: type: string nullable: true description: The full-sized image xs: type: string nullable: true description: 75x75 sm: type: string nullable: true description: 300x300 required: - raw - xs - sm description: >- An image of the feed actor. Use this field for maximum forward compatibility. profile: type: object properties: id: type: string name: type: string images: type: object properties: raw: type: string nullable: true description: The full-sized image xs: type: string nullable: true description: 75x75 sm: type: string nullable: true description: 300x300 required: - raw - xs - sm description: URLs for different size squares. addresses: type: array items: type: string externalId: type: string metadata: type: object properties: farcasterUsername: type: string nullable: true farcasterId: type: number nullable: true lensHandle: type: string nullable: true ensName: type: string nullable: true twitterHandle: type: string nullable: true debankName: type: string nullable: true hlName: type: string nullable: true commentCount30d: type: number nullable: true pnl30d: type: number nullable: true winRate30d: type: number nullable: true tradeCount30d: type: number nullable: true roiPercent30d: type: number nullable: true pnl7d: type: number nullable: true winRate7d: type: number nullable: true tradeCount7d: type: number nullable: true roiPercent7d: type: number nullable: true medianHoldingTimeMinutes: type: number nullable: true required: - farcasterUsername - farcasterId - lensHandle - ensName - twitterHandle - debankName - hlName - commentCount30d - pnl30d - winRate30d - tradeCount30d - roiPercent30d - pnl7d - winRate7d - tradeCount7d - roiPercent7d - medianHoldingTimeMinutes isNSFW: anyOf: - type: boolean enum: - false - type: object properties: nsfwImage: type: boolean nsfwText: type: boolean required: - nsfwImage - nsfwText description: >- `false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content. required: - id - name - images - addresses - metadata - isNSFW description: >- Profile of the user (including additional known addresses and extra metadata). Use this field to tailor your UI specifically. required: - type - address - name - images - profile description: >- The actor that completed an action to create a feed item. timestamp: type: number description: Unix timestamp of when the reply was created likeCount: type: number description: The number of likes on this reply isLikedByUser: type: boolean description: >- Whether the requesting user has liked this reply required: - id - text - author - timestamp - likeCount - isLikedByUser description: >- Replies to this comment, only included when fetching a single position required: - uid - transactionHash - chain - tokenAddress - commentText - timestamp - isAppUserComment - metrics alphaTags: type: object additionalProperties: type: number description: >- Alpha tags with their scores that caused this trade to be highlighted example: big_entry: 198371.27 maxAlphaScore: type: number description: The highest alpha score across all tags for this trade required: - tokenAmount - usdCost - marketCap - timestamp - transactionHash - direction - classification - intent - perpPositionType - perpLeverage - comments - alphaTags - maxAlphaScore description: >- Present only in For You feed. Highlights the specific trade with alpha tags that triggered recommendation. required: - totalCompletions - itemTitle - callToActions - metadata - insights - metrics - itemId - transactionHash - timestamp - cardLatestTradeAt - actor description: >- A position with optional For You feed data. The forYouTrade field highlights the specific trade that triggered recommendation. pagination: type: object properties: olderCursor: type: string nullable: true olderItemsURL: type: string nullable: true newerCursor: type: string nullable: true newerItemsURL: type: string nullable: true required: - olderCursor - olderItemsURL - newerCursor - newerItemsURL required: - items - pagination securitySchemes: bearerAuth: type: http scheme: bearer ````