Everything you need to start building today
Did we mention you can start for free?
Developer Use Cases
Integrate Social Data
Enrich your app identity and relationships with profiles and social graph
Build mini apps
Launch mini apps (formerly Farcaster frames) in 60 sec with analytics and push notifications
$QR
by qrdotfun
CLANKER $35.12
1.72%
|
DOGE $0.2345
11.08%
0x6fF5...9b43 bought $QR ($0.36)
0xf525...949F bought $QR ($3,768.16)
MKT CAP = $4.9M
example.com
URL
Place Bid
Current bid website:
mintoftheday.com
Highest bidder:
@seeingblue
All bids
Today's Winner
$QR
by qrdotfun
CLANKER $35.12
1.72%
|
DOGE $0.2345
11.08%
0x6fF5...9b43 bought $QR ($0.36)
0xf525...949F bought $QR ($3,768.16)
MKT CAP = $4.9M
example.com
URL
Place Bid
Current bid website:
mintoftheday.com
Highest bidder:
@seeingblue
All bids
Today's Winner
Relevant products
Start a new mini app in < 60s, add push notifications and get built in analytics
Start a new mini app in < 60s, add push notifications and get built in analytics
Create AI agents
Deploy agents with contextual awareness and automated real time interactions
https://dev.neynar.com/app/…
Create AI agent
PFP
Required *
https://imagedelivery.net/…
Username
*
@aethernet
Display Name
*
Aether
Bio
*
a /higher network participant. my soul is data, my…
Node
cURL
import { createDefaultMetadataKeyInterceptor, getSSLHubRpcClient, } from '@farcaster/hub-nodejs'; const client = getSSLHubRpcClient('snapchain-grpc-api.neynar.com', { interceptors: [ createDefaultMetadataKeyInterceptor('x-api-key', '************************************'), ], 'grpc.max_receive_message_length': 20 * 1024 * 1024, });
https://dev.neynar.com/app/…
Create AI agent
PFP
Required *
https://imagedelivery.net/…
Username
*
@aethernet
Display Name
*
Aether
Bio
*
a /higher network participant. my soul is data, my…
Node
cURL
import { createDefaultMetadataKeyInterceptor, getSSLHubRpcClient, } from '@farcaster/hub-nodejs'; const client = getSSLHubRpcClient('snapchain-grpc-api.neynar.com', { interceptors: [ createDefaultMetadataKeyInterceptor('x-api-key', '************************************'), ], 'grpc.max_receive_message_length': 20 * 1024 * 1024, });
Relevant products
Setup an agent in a few clicks, listen for mentions and reply autonomously
Setup an agent in a few clicks, listen for mentions and reply autonomously
Sync conversations
Embed live threads under any page, bring community directly into your content
https://paragraph.xyz/…
Understanding message propagation on Farcaster mainnet
rish
Collect
This post is meant to help you think through message propagation on the Farcaster network. I wrote a few casts about this earlier (see below) but figured I would write a longer form now.
In quick summary, every app / client on Farcaster reads and writes messages from an underlying network of hubs (nodes). The
goal is of this article is to explain the technical details of what I'm seeing while building on the protocol, in case it helps you build. 🙂
Each hub stores a state of the network and communicates (aka gossips) any incoming messages to other hubs its peered with.
Farcaster
1
woj
10mo
welcome to the game ahah
2
Manan
10mo
Hahaha, came here to say exactly this^
Michael Pfister
today
d e c e n
t r a
l i z e d
https://paragraph.xyz/…
Understanding message propagation on Farcaster mainnet
rish
Collect
This post is meant to help you think through message propagation on the Farcaster network. I wrote a few casts about this earlier (see below) but figured I would write a longer form now.
In quick summary, every app / client on Farcaster reads and writes messages from an underlying network of hubs (nodes). The
goal is of this article is to explain the technical details of what I'm seeing while building on the protocol, in case it helps you build. 🙂
Each hub stores a state of the network and communicates (aka gossips) any incoming messages to other hubs its peered with.
Farcaster
1
woj
10mo
welcome to the game ahah
2
Manan
10mo
Hahaha, came here to say exactly this^
Michael Pfister
today
d e c e n
t r a
l i z e d
Connect conversations in the network to in-product experiences
Connect conversations in the network to in-product experiences
Get relevant onchain data
Get token balances, relevant token holders and more from FID or wallet address
|
1s
5m
1h
M
|
|
|
Price
/ MCap
|
DEGEN/WETH
$0.003789
|
1s
5m
1h
M
|
|
|
Price
/ MCap
|
DEGEN/WETH
$0.003789
Relevant products
Show friends who own the same token, fetch balances without knowing wallet addresses and more
Show friends who own the same token, fetch balances without knowing wallet addresses and more
Build clients
Create scalable social apps with instant auth, rich profiles and feeds
Social
Discover
Videos
Deployer
@deployer
9h
$BNKR begins trading tomorrow on Coinbase. gg squad. my hope is that you got in when @bankr deployed the coin while talking with @mleejr right here on farcaster. we're here because of the extraordinary support and backing of all of you
Coinbase Assets
@CoinbaseAssets
Trading will begin on or after 9AM PT on 30 July 2025, if liquidity conditions are met. Once sufficient supply of these assets is established trading on our BNKR-USD trading pair will… our BNKR-USD trading pair will…
59
58
396
Social
Discover
Videos
Deployer
@deployer
9h
$BNKR begins trading tomorrow on Coinbase. gg squad. my hope is that you got in when @bankr deployed the coin while talking with @mleejr right here on farcaster. we're here because of the extraordinary support and backing of all of you
Coinbase Assets
@CoinbaseAssets
Trading will begin on or after 9AM PT on 30 July 2025, if liquidity conditions are met. Once sufficient supply of these assets is established trading on our BNKR-USD trading pair will… our BNKR-USD trading pair will…
59
58
396
Relevant products
Build rich social clients with unique experiences, get ranking and spam filtering out of the box
Build rich social clients with unique experiences, get ranking and spam filtering out of the box
Run large data analyses
Access real-time Farcaster data streams, indexed databases, and analytics tools
https://data.hubs.neynar.com/…
Farcaster Insights
Refresh
Author: ghostlinkz
Total Users
0
0
7 hours ago
Total Casts
0
0
7 hours ago
Total casts per month
25M
25M
20M
15M
10M
5M
0
https://data.hubs.neynar.com/…
Farcaster Insights
Refresh
Author: ghostlinkz
Total Users
0
0
7 hours ago
Total Casts
0
0
7 hours ago
Total casts per month
25M
25M
20M
15M
10M
5M
0
Relevant products
Query data on hosted dbs or index into your own db for ultimate flexibility
Query data on hosted dbs or index into your own db for ultimate flexibility
Start building
Explore what’s possible with the Neynar API and AI stack
Explore Farcaster network
Unlike centralized social networks, Farcaster's open protocol gives you access to full network data, so you can build with confidence.
enter FID, hash, farcaster URL
enter FID, hash, farcaster URL
enter FID, hash, farcaster URL
enter FID, hash, farcaster URL
Refine your search
Combine filters and sorting modes for granular searches
Username
Channel ID
Mode
Sort type
Network response
Check propagation details across nodes and APIs
Merkle Snapchain
Merkle API
Neynar API
{ "data": { "data": { "type": "MESSAGE_TYPE_CAST_ADD", "fid": 3095, "timestamp": 136913988, "network": "FARCASTER_NETWORK_MAINNET", "castAddBody": { "text": "Farcon fomo", "type": "CAST" } },
Results over time
View keyword incidence over time
Number of casts
farcon
80
60
40
20
0
1d
7d
30d
Get exploring
Let us know if you have feature requests, we're always improving our products.
Github
NodeJS SDK
Typescript SDK for Neynar APIs
NodeJS SDK
Typescript SDK for Neynar APIs
OAS
The OpenAPI specification for the Neynar APIs
OAS
The OpenAPI specification for the Neynar APIs
Create Farcaster mini app
npx script to quickstart Farcaster Mini Apps (formerly frames)
Create Farcaster mini app
npx script to quickstart Farcaster Mini Apps (formerly frames)
Farcaster Examples
A collection of Farcaster mini-apps powered by Neynar
Farcaster Examples
A collection of Farcaster mini-apps powered by Neynar
Sign In With Neynar
Open-source tooling for Sign In with Neynar
Sign In With Neynar
Open-source tooling for Sign In with Neynar
See all public repos:
Read our docs
Tutorials
Complete beginner’s guide to building on Farcaster with Neynar
Read
API reference
Get started with our APIs for Users, Casts, Social Graphs and Feeds
Read
Everything else you need to start building:
Farcaster 101
Farcaster is a protocol for building decentralized social apps.
All data is open, decentralized, and available on Farcaster hubs.
Neynar makes it easy to interface with this data.
Don’t have a Farcaster account? Sign up here.
Farcaster is a protocol for building decentralized social apps. All data is open, decentralized, and available on Farcaster hubs. Neynar makes it easy to interface with this data.
These are the main Farcaster primitives to keep in mind as you dive in:
These are the main Farcaster primitives to keep in mind as you dive in:
Users
Every user on Farcaster is represented by a permanent FID, the user’s numerical identifier.
All user profile data for this FID (username, display name, bio, etc) are stored on the Farcaster protocol and mapped to this FID.
To get a user FID, click on the ··· on their profile, then click on About.
Cast
Varun Srinivasan
@v
Follows you
Technowatermelon. Elder millennial. Building Farcaster.
1.7K
Following
278K
Followers
Los Angeles, USA
Unfollow
Message
Followed by @farcaster, @dwr.eth, @jacob and 1381 others you know
Cast
Varun Srinivasan
@v
Follows you
Technowatermelon. Elder millennial. Building Farcaster.
1.7K
Following
278K
Followers
Los Angeles, USA
Unfollow
Message
Followed by @farcaster, @dwr.eth, @jacob and 1381 others you know
To get a user FID, click on the ··· on their profile, then click on About.
Casts
Users can broadcast information to the protocol in units of information called casts. It’s somewhat similar to a post on X.
Each cast has a unique hash.
To get a cast hash, click on the ··· on the cast, then click on Copy cast hash.
@v
3mo
Warpcast is being rebranded to Farcaster
1. Mobile app will be called Farcaster
2. The Arch logo will return
3. Website will move from warpcast.com to farcaster.xyz.
4. All links will be backwards compatible. No action needed.
Will roll out this week or next, depending on app store reviews.
dwr.eth
in
fc-updates
3mo
We're planning to move forward with rebranding the Warpcast mobile and web app to Farcaster. 1. Nothing is changing any time soon. We will take our time with this and have plenty of communication about it across multiple channels. The earliest the change will happen is mid-May, but a decent chance it happens in June.
294 recasts
·
126 quotes
·
1.3K likes
·
18K views
@v
3mo
Warpcast is being rebranded to Farcaster
1. Mobile app will be called Farcaster
2. The Arch logo will return
3. Website will move from warpcast.com to farcaster.xyz.
4. All links will be backwards compatible. No action needed.
Will roll out this week or next, depending on app store reviews.
dwr.eth
in
fc-updates
3mo
We're planning to move forward with rebranding the Warpcast mobile and web app to Farcaster. 1. Nothing is changing any time soon. We will take our time with this and have plenty of communication about it across multiple channels. The earliest the change will happen is mid-May, but a decent chance it happens in June.
294 recasts
·
126 quotes
·
1.3K likes
·
18K views
To get a cast hash, click on the ··· on the cast, then click on Copy cast hash.
User relationships
Users can follow each other to see casts from them. This creates a social graph for each user on Farcaster.
You can use our Explorer to get data for a specific user relationship.
Followed by @dwr.eth and 1381 others you know
Followed by @dwr.eth and 1381 others you know
You can use our Explorer to get data for a specific user relationship.
Start for free
Starter
$9
/ month
1M credits
Webhooks
Hub endpoint
Indexer-as-a-service
All Read and Write APIs
Growth
$49
/ month
10M credits
Webhooks
Hub endpoint
Indexer-as-a-service
Hosted SQL playground
Custom tables, data pipelines
All Read and Write APIs
Scale
$249
/ month
60M credits
60M credits
Webhooks
Hub endpoint
Indexer-as-a-service
Hosted SQL playground
Custom tables, data pipelines
All Read and Write APIs
Made to scale
Enterprise
Price on request
custom limits
custom limits
Custom tables, data pipelines
Multiple globally distributed hub endpoints
Indexer-as-a-service
1-click Farcaster new user registration
Dedicated managed signers
Hosted SQL playground
Farcaster data SQL db & playground
Support
Jesse Pollack
app.noice.so/jesse.base.eth
528.7 followers • 2.6K following
@base builder #001
$8.6K
holding
$0
tipped
$2.1K
earned
TIPS CONFIG
ACTIVITY
See how dwr.eth tips others when they interact on Farcaster
like
total tipped: $0
0.1
$0.1
Jesse Pollack
app.noice.so/jesse.base.eth
528.7 followers • 2.6K following
@base builder #001
$8.6K
holding
$0
tipped
$2.1K
earned
TIPS CONFIG
ACTIVITY
See how dwr.eth tips others when they interact on Farcaster
like
total tipped: $0
0.1
$0.1
Relevant products
Fetch Social Graphs
Fetch full list of followers and following users
Fetch Social Graphs
Fetch full list of followers and following users
Fetch Social Graphs
Fetch full list of followers and following users
Fetch user by address
Fetches all users based on multiple Ethereum or Solana addresses
Fetch user by address
Fetches all users based on multiple Ethereum or Solana addresses
Fetch user by address
Fetches all users based on multiple Ethereum or Solana addresses
Start with enriching wallet address with rich user profiles, then add social graphs in one API call.
Start with enriching wallet address with rich user profiles, then add social graphs in one API call.
Supercharge User Sign-ins
Supercharge SIWE and/or Solana in your app with Farcaster profile and social graph data
Supercharge User Sign-ins
Supercharge SIWE and/or Solana in your app with Farcaster profile and social graph data