General Swap Feed

Get a paginated feed of swaps from Farcaster users, optionally adding weight for a provided FID's followed users. Provides real-time swap activity tailored to a Farcaster user's social graph.

`generalSwapFeed`

Returns a paginated list of swap transactions from Farcaster users. The feed can be personalized by providing a Farcaster ID (FID) to emphasize swaps for a user's followed accounts.

Real-time swap activity from Farcaster users
Social graph weighting based on followed users
Cross-chain swap tracking
Paginated results with cursor-based navigation
Volume and transaction metadata

Example Use Case: Farcaster Swap Feed

Get the latest swap activity from your Farcaster network, with emphasis on users you follow.

Try it now

Example Query

query GeneralSwapFeed {
  generalSwapFeed {
    pageInfo {
      hasPreviousPage
      hasNextPage
      startCursor
      endCursor
    }
    edges {
      cursor
      node {
        id
        type
        swap {
          amount
          chainId
          fid
          id
          isBuy
          parentUrl
          timestamp
          transactionHash
          volumeUsd
          network {
            chainId
          }
          farcasterContext {
            likeCount
          }
          profile {
            fid
          }
          token {
            address
            symbol
          }
        }
      }
    }
  }
}

Example Response

{
  "data": {
    "generalSwapFeed": {
      "pageInfo": {
        "hasPreviousPage": false,
        "hasNextPage": true,
        "startCursor": null,
        "endCursor": "TmpoalpEZzBPREUwTkRSbE1tTTJObVZrWVdZeVpEbGxmRFk9"
      },
      "edges": [
        {
          "cursor": "NjhjZDg0ODE0NDRlMmM2NmVkYWYyZDllfDY=",
          "node": {
            "id": "Q2hhbm5lbEZlZWRTd2FwLWV0aGVyZXVtfDB4MzBjM2FhN2MxM2MxMzJhZTUxMzgwZTdhZDhiYzhmMWZhMmY2YzUxMTE5ODYxMTk3NzA5N2I1NmU1NTg1NDcwOXwzMDN8MTc1ODI5ODYzMTAwMHwweGM1MDY3M2VkYjNhN2I5NGU4Y2FkOGE3ZDRlMGNkNjg4NjRlMzNlZGZ8dHJ1ZQ==",
            "type": "swap",
            "swap": {
              "amount": 215842.47257994284,
              "chainId": 1,
              "fid": 303,
              "id": "Q2hhbm5lbEZlZWRTd2FwLWV0aGVyZXVtfDB4MzBjM2FhN2MxM2MxMzJhZTUxMzgwZTdhZDhiYzhmMWZhMmY2YzUxMTE5ODYxMTk3NzA5N2I1NmU1NTg1NDcwOXwzMDN8MTc1ODI5ODYzMTAwMHwweGM1MDY3M2VkYjNhN2I5NGU4Y2FkOGE3ZDRlMGNkNjg4NjRlMzNlZGZ8dHJ1ZQ==",
              "isBuy": true,
              "parentUrl": "swap://Q2hhbm5lbEZlZWRTd2FwLWV0aGVyZXVtfDB4MzBjM2FhN2MxM2MxMzJhZTUxMzgwZTdhZDhiYzhmMWZhMmY2YzUxMTE5ODYxMTk3NzA5N2I1NmU1NTg1NDcwOXwzMDN8MTc1ODI5ODYzMTAwMHwweGM1MDY3M2VkYjNhN2I5NGU4Y2FkOGE3ZDRlMGNkNjg4NjRlMzNlZGZ8dHJ1ZQ==",
              "timestamp": 1758298631000,
              "transactionHash": "0x30c3aa7c13c132ae51380e7ad8bc8f1fa2f6c511198611977097b56e55854709",
              "volumeUsd": "4484.7698966",
              "network": {
                "chainId": 1
              },
              "farcasterContext": {
                "likeCount": 0
              },
              "profile": {
                "fid": 303
              },
              "token": {
                "address": "0xc50673edb3a7b94e8cad8a7d4e0cd68864e33edf",
                "symbol": "PNKSTR"
              }
            }
          }
        },
        {
          "cursor": "NjhjZDg0ODE0NDRlMmM2NmVkYWYyZDllfDY=",
          "node": {
            "id": "Q2hhbm5lbEZlZWRTd2FwLWV0aGVyZXVtfDB4ZTgwNzkwYThhNWUxZDJlZTI4MmFhOGU0Mjk0OGIxM2U4MTZjNDkxYmQyYzA5MWRiMmU2ODAyZmIyMzQ1OTNjM3wyMjE1Nzh8MTc1ODI5NzEwNzAwMHwweGM1MDY3M2VkYjNhN2I5NGU4Y2FkOGE3ZDRlMGNkNjg4NjRlMzNlZGZ8dHJ1ZQ==",
            "type": "swap",
            "swap": {
              "amount": 115964.3610503389,
              "chainId": 1,
              "fid": 221578,
              "id": "Q2hhbm5lbEZlZWRTd2FwLWV0aGVyZXVtfDB4ZTgwNzkwYThhNWUxZDJlZTI4MmFhOGU0Mjk0OGIxM2U4MTZjNDkxYmQyYzA5MWRiMmU2ODAyZmIyMzQ1OTNjM3wyMjE1Nzh8MTc1ODI5NzEwNzAwMHwweGM1MDY3M2VkYjNhN2I5NGU4Y2FkOGE3ZDRlMGNkNjg4NjRlMzNlZGZ8dHJ1ZQ==",
              "isBuy": true,
              "parentUrl": "swap://Q2hhbm5lbEZlZWRTd2FwLWV0aGVyZXVtfDB4ZTgwNzkwYThhNWUxZDJlZTI4MmFhOGU0Mjk0OGIxM2U4MTZjNDkxYmQyYzA5MWRiMmU2ODAyZmIyMzQ1OTNjM3wyMjE1Nzh8MTc1ODI5NzEwNzAwMHwweGM1MDY3M2VkYjNhN2I5NGU4Y2FkOGE3ZDRlMGNkNjg4NjRlMzNlZGZ8dHJ1ZQ==",
              "timestamp": 1758297107000,
              "transactionHash": "0xe80790a8a5e1d2ee282aa8e42948b13e816c491bd2c091db2e6802fb234593c3",
              "volumeUsd": "2236.85",
              "network": {
                "chainId": 1
              },
              "farcasterContext": {
                "likeCount": 0
              },
              "profile": {
                "fid": 221578
              },
              "token": {
                "address": "0xc50673edb3a7b94e8cad8a7d4e0cd68864e33edf",
                "symbol": "PNKSTR"
              }
            }
          }
        }
      ]
    }
  }
}

Arguments

Argument	Description	Type	Required
`first`	Number of swap items to fetch (default: 6)	`Int`	No
`after`	Cursor for pagination	`String`	No
`fid`	Farcaster ID to weight feed for followed users	`Int`	No

Fields

Field	Description	Type
`pageInfo`	Pagination information	`PageInfo!`
`edges`	Array of swap feed results	`[FarcasterSwapFeedV2Edge!]!`

FarcasterSwapFeedV2Edge Fields

Field	Description	Type
`cursor`	Pagination cursor for this item	`String!`
`node`	The swap feed item data	`FarcasterRelevantSwapFeedItem!`

FarcasterRelevantSwapFeedItem Fields

Field	Description	Type
`id`	Unique identifier	`ID!`
`type`	Type of feed item	`String!`
`swap`	Detailed swap information	`ChannelFeedSwap`

ChannelFeedSwap Fields

Field	Description	Type
`id`	Unique identifier	`ID!`
`fid`	Farcaster ID of the swapper	`Int!`
`transactionHash`	Transaction hash on blockchain	`String!`
`timestamp`	When the swap occurred	`Timestamp!`
`chainId`	Chain ID where swap occurred	`Int!`
`volumeUsd`	USD value of the swap	`String!`
`amount`	Token amount swapped	`Float!`
`isBuy`	Whether this was a buy or sell	`Boolean!`
`parentUrl`	Associated Farcaster parent URL	`String!`
`topHat`	Farcaster top hat context	`FarcasterTopHat`
`farcasterContext`	FIP-2 context data (requires fid param)	`FarcasterFip2Context!`
`network`	Network information	`NetworkObject!`
`token`	Token information	`FungibleToken`
`profile`	Farcaster profile data	`FarcasterProfile`

PageInfo Fields

Field	Description	Type
`hasPreviousPage`	Whether there are previous results	`Boolean!`
`hasNextPage`	Whether there are more results	`Boolean!`
`startCursor`	Cursor of the first item in results	`String`
`endCursor`	Cursor of the last item in results	`String`

FarcasterFip2Context Fields

Field	Description	Type
`id`	Unique identifier	`ID!`
`uri`	URI of the Farcaster cast	`String!`
`likeCount`	Number of likes on the cast	`Int!`
`recastCount`	Number of recasts	`Int!`
`commentCount`	Number of comments (deprecated)	`Int!`
`replyCount`	Number of replies	`Int!`
`quoteCount`	Number of quote casts	`Int!`
`isLiked`	Whether the cast is a like	`Boolean!`
`isRecast`	Whether the cast is a recast	`Boolean!`

generalSwapFeed​

Example Use Case: Farcaster Swap Feed​

Example Query​

Example Response​

Arguments​

Fields​

FarcasterSwapFeedV2Edge Fields​

FarcasterRelevantSwapFeedItem Fields​

ChannelFeedSwap Fields​

PageInfo Fields​

FarcasterFip2Context Fields​