Hub HTTP APIs

Casts
VersionTypeMethodCu
v1GET/v1/castById1
/v1/castsByFid200
/v1/castsByParent200
Reactions
VersionTypeMethodCU
v1GET/v1/reactionById1
/v1/reactionsByFid200
/v1/reactionsByCast150
/v1/reactionsByTarget150
Follows
VersionTypeMethodCU
v1GET/v1/linkById1
/v1/linksByFid200
/v1/linksByTargetFid200
User
VersionTypeMethodCU
v1GET/v1/userDataByFid1
/v1/fids2000
/v1/storageLimitsByFid5
/v1/userNameProofByName2
/v1/userNameProofsByFid2
/v1/verificationsByFid5
/v1/onChainSignersByFid15
Messages
VersionTypeMethodCU
v1POST/v1/submitMessage150
/v1/validateMessage4
Events
VersionTypeMethodCU
v1GET/v1/onChainIdRegistryEventByAddress2
/v1/eventById1
/v1/events2000

Hub gRPC APIs

WIP Hub gRPC APIs and Hub gRPC streaming pricing will be added soon.

Neynar APIs

User
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/user/search10
/v2/farcaster/user/bulk1number of fids
/v2/farcaster/user/bulk-by-address1number of addresses
/v2/farcaster/user/custody-address1
/v2/farcaster/user/active1page limit
PATCH/v2/farcaster/user20
POST/v2/farcaster/user/verification10
/v2/farcaster/user/follow10
DELETE/v2/farcaster/user/verification10
/v2/farcaster/user/follow10
/v2/farcaster/reaction10
Cast
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/cast2
/v2/farcaster/casts50
POST/v2/farcaster/cast150
DELETE/v2/farcaster/cast10
Feed
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/feed4page limit
/v2/farcaster/feed/following4page limit
/v2/farcaster/feed/channels4page limit
/v2/farcaster/feed/frames4page limit
/v2/farcaster/feed/user/{fid}/popular4page limit
/v2/farcaster/feed/user/{fid}/replies_and_recasts4page limit
Reactions
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/reactions/user2page limit
GET/v2/farcaster/reactions/cast2page limit
POST/v2/farcaster/reaction10
Frame
VersionTypeMethodCUMultiplier
v2POST/v2/farcaster/frame/action20
/v2/farcaster/frame/validate0
Notifications
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/notifications5page limit
/v2/farcaster/notifications/parent_url5page limit
/v2/farcaster/notifications/channel5page limit
Channel
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/channel/list2page limit
/v2/farcaster/channel/search20
/v2/farcaster/channel2
/v2/farcaster/channel/followers1page limit
/v2/farcaster/channel/users1page limit
/v2/farcaster/channel/trending4page limit
Follows
VersionTypeMethodCUMultiplier
v2GETv2/farcaster/followers/relevant20
fname
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/fname/availability1
Storage
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/storage/allocations1
/v2/farcaster/storage/usage1
Signer
VersionTypeMethodCUMultiplier
v2GET/v2/farcaster/signer0
GET/v2/farcaster/signer/developer_managed0
POST/v2/farcaster/signer2
/v2/farcaster/signer/signed_key5
/v2/farcaster/signer/developer_managed/signed_key5
20,000 CUs per monthly active signer per month, where active signer = signers used by developer to write to the protocol in specific time period Message
VersionTypeMethodCU
v2POSTv2/farcaster/message150

Webhooks

Event typeFilterCU
user.created5
user.updatedfids10
cast.createdfids15
mention_fids15
author_fids15
root_parent_urls15
parent_url15
embeds15
reaction.createdfids15
target_fids15
reaction.deletedfids15
target_fids15
follow.createdfids15
target_fids15
follow.deletedfids15
target_fids15