Farcaster Data

Access onchain data for Farcaster users across 50+ chains in a single API.

Onchain portfolios for every user

Transaction history

Profile metadata & connected addresses

Identity Integration

Any token holders, transaction participants, or NFT owners can resolve automatically to FIDs & metadata, allowing you to combine onchain data with Farcaster social context out-of-the-box.

Onchain Data

Access all connected addresses for any Farcaster user, enabling you to fetch complete onchain data across 50+ chains.

Portfolio Data

Get the complete portfolio of any Farcaster user using their connected addresses.

Query multiple addresses in a single call

Real-time token, NFT, and DeFi balances

Multi-chain portfolio totals

USD valuations across all holdings

Read Documentation Try it now

{
  "data": {
    "portfolioV2": {
      "tokenBalances": {
        "totalBalanceUSD": 292328.8286857288,
        "byToken": {
          "totalCount": 1223,
          "edges": [
            {
              "node": {
                "symbol": "ETH",
                "tokenAddress": "0x0000000000000000000000000000000000000000",
                "balance": 17.286417826281596,
                "balanceUSD": 45317.035788310255,
                "price": 2621.54,
                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png",
                "name": "Ethereum",
                "network": {
                  "name": "Base"
                }
              }
            },
            {
              "node": {
                "symbol": "SYNDOG",
                "tokenAddress": "0x3d1d651761d535df881740ab50ba4bd8a2ec2c00",
                "balance": 30000000,
                "balanceUSD": 38615.1,
                "price": 0.00128717,
                "imgUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x3d1d651761d535df881740ab50ba4bd8a2ec2c00.png",
                "name": "Synthesizer Dog",
                "network": {
                  "name": "Base"
                }
              }
            }
          ]
        }
      },
      "appBalances": {
        "totalBalanceUSD": 1788.726036163165
      },
      "nftBalances": {
        "totalBalanceUSD": 164.6907089747224
      }
    }
  }
}

Transaction History

Get a comprehensive feed of all onchain activity for any Farcaster user across multiple chains.

Native Farcaster resolution on all transactions

Multi-chain activity in a single query

Categorized transaction types

Complete transaction metadata

Read Documentation Try it now

{
  "data": {
    "transactionHistoryV2": {
      "edges": [
        {
          "node": {
            "fromAddress": {
              "farcasterProfile": {
                "username": "dwr.eth",
                "fid": 3,
                "metadata": {
                  "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original",
                  "displayName": "Dan Romero"
                }
              }
            },
            "interpretation": {
              "processedDescription": "Sent 9.999 USDC to 0x661e...ab35",
              "description": "Sent $1 to $2",
              "descriptionDisplayItems": [
                {
                  "type": "token",
                  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
                  "amountRaw": "9999000",
                  "network": "BASE_MAINNET",
                  "tokenV2": {
                    "decimals": 6,
                    "symbol": "USDC",
                    "name": "USD Coin",
                    "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.png",
                    "priceData": {
                      "price": 1.00001453,
                      "priceChange5m": -0.1742210149284551,
                      "priceChange1h": 0.19775680350238023,
                      "priceChange24h": 0,
                      "volume24h": 453001120,
                      "totalLiquidity": 70642344.14275794,
                      "marketCap": 157454220.3565744
                    }
                  }
                },
                {
                  "type": "actor",
                  "address": "0x661e2209b9c6b06c1f32a0639f60d3294185ab35",
                  "account": {
                    "farcasterProfile": {
                      "fid": 2,
                      "username": "v",
                      "metadata": {
                        "imageUrl": "https://i.seadn.io/gae/sYAr036bd0bRpj7OX6B-F-MqLGznVkK3--DSneL_BT5GX4NZJ3Zu91PgjpD9-xuVJtHq0qirJfPZeMKrahz8Us2Tj_X8qdNPYC-imqs?w=500&auto=format",
                        "displayName": "Varun Srinivasan"
                      }
                    }
                  }
                }
              ]
            },
            "perspectiveDelta": {
              "account": {
                "address": "0x187c7b0393ebe86378128f2653d0930e33218899",
                "displayName": {
                  "value": "Dan Romero",
                  "source": "FARCASTER"
                },
                "farcasterProfile": {
                  "fid": 3,
                  "username": "dwr.eth",
                  "metadata": {
                    "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original"
                  }
                }
              },
              "tokenDeltasV2": {
                "edges": [
                  {
                    "node": {
                      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
                      "amount": -9.999,
                      "amountRaw": "-9999000",
                      "token": {
                        "symbol": "USDC",
                        "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.png",
                        "onchainMarketData": {
                          "price": 1.00001453,
                          "priceChange24h": 0
                        }
                      }
                    }
                  }
                ]
              }
            },
            "eventHash": "75b383d6"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "event_hash_75b383d6"
      }
    }
  }
}

Token Holders

Surface Farcaster profiles for any token holders, enabling you to connect token data with social context.

Top holder lists with Farcaster profiles

Ownership percentages and balances

Resolve wallet addresses to social identities

Filter holders by various criteria

Read Documentation Try it now

{
  "data": {
    "fungibleToken": {
      "holders": {
        "edges": [
          {
            "node": {
              "holderAddress": "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
              "percentileShare": 2.4354700234160593,
              "value": "24354700234160593151051034",
              "account": {
                "displayName": {
                  "value": "jesse.xyz",
                  "source": "ENS"
                },
                "farcasterProfile": {
                  "username": "jessepollak",
                  "fid": 99,
                  "metadata": {
                    "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1013b0f6-1bf4-4f4e-15fb-34be06fede00/original",
                    "warpcast": "https://warpcast.com/jessepollak"
                  }
                }
              }
            }
          },
          {
            "node": {
              "holderAddress": "0xd2bd1c166e0d2b2b57a6e9ef2a5cd2c24268c9b5",
              "percentileShare": 1.8765432109876543,
              "value": "18765432109876543210987654",
              "account": {
                "displayName": {
                  "value": "dwr.eth",
                  "source": "ENS"
                },
                "farcasterProfile": {
                  "username": "dwr",
                  "fid": 3,
                  "metadata": {
                    "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/e4a5568f-3cbc-4f83-2f72-1c4999e89b00/original",
                    "warpcast": "https://warpcast.com/dwr"
                  }
                }
              }
            }
          }
        ]
      }
    }
  }
}

Ready to start building with Farcaster data?

If you need help with implementation or have other questions our team is here to help.

Book a Call