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 nowExample 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! |