Neynar HubEvents API is one of 39 APIs that Neynar publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include HubEvents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and rate-limit docs.
This API exposes
2 operations
across 2 paths,
and defines 58 schemas.
It is described by OpenAPI 3.2.0, at version 2.35.0.
Requests are made against a single base URL, https://snapchain-api.neynar.com.
2 operations2 paths58 schemas2 GET
Metadata
The identity and technical contract details declared by the specification.
Neynar HubEvents API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as x-api-key (ApiKeyAuth).
By default, every request must be authenticated.
ApiKeyAuth — API key to authorize requests
Paths & Operations 2
Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.
HubEvents 2
Operations related to hub events.
GET
/v1/events
Page of events
fetch-events1 param→ 200default
GET
/v1/eventById
Event by ID
lookup-event1 param→ 200default
Schemas 58
The contract defines 58 schemas that model the data the API accepts and returns. The most detailed are OnChainEventCommon (9 properties), CastAddBody (7 properties), UserNameProof (6 properties), ErrorResponse (6 properties). Each schema is shown below with its type and property counts.
CastId
object
A unique identifier for a cast (post) in the Farcaster network, consisting of the creator's FID and a hash of the cast's content. This combination ensures glob…
2 properties2 required
MessageType
string
Type of the MessageBody. - MESSAGETYPECASTADD: Add a new Cast - MESSAGETYPECASTREMOVE: Remove an existing Cast - MESSAGETYPEREACTIONADD: Add a Reaction to a Ca…
VerificationRemoveBody
object
Contains the data required to remove a previously added blockchain address verification from a user's profile. This operation permanently removes the verificat…
1 property1 required
HashScheme
string
Type of hashing scheme used to produce a digest of MessageData. - HASHSCHEMEBLAKE3: Default scheme for hashing MessageData
OnChainEventSignerMigrated
HubEventMergeUsernameProof
object
3 properties3 required
MessageDataVerificationAdd
Represents a message that adds verification of ownership for an Ethereum or Solana address to a user's profile. This verification proves that the user controls…
SignerMigratedEventBody
object
1 property1 required
MessageDataLink
Represents a social graph connection between users in the Farcaster network. Currently supports following relationships between users.
MessageDataUsernameProof
MergeOnChainEventBody
object
1 property1 required
MessageDataCastAdd
Represents a new cast (post) being created in the Farcaster network. A cast can include text content, mentions of other users, embedded URLs, and references to…
CastAddBody
object
Adds a new Cast
7 properties5 required
MergeUserNameProofBody
object
4 properties
LinkType
string
Defines the type of social connection between users. - follow: Establishes a following relationship where the user will receive updates from the target user in…
OnChainEventCommon
object
9 properties9 required
OnChainEventIdRegister
ErrorResponse
object
6 properties6 required
HubEvent
UserNameType
string
MessageDataReaction
Represents a user's reaction to content on the Farcaster network. Reactions can be likes or recasts of casts, allowing users to express appreciation or share c…
SignerEventBody
object
5 properties5 required
OnChainEvent
HubEventMergeOnChainEvent
object
3 properties3 required
UserNameProof
object
6 properties6 required
LinkBody
object
Defines a social connection between users in the Farcaster network. Currently used to establish following relationships, allowing users to curate their content…
3 properties2 required
VerificationAddEthAddressBody
object
Contains the data required to verify ownership of an Ethereum or Solana address. The verification process requires a cryptographic signature from the blockchai…
3 properties3 required
UserDataType
string
Specifies which field of a user's profile is being updated. - USERDATATYPEPFP: Profile Picture URL for the user's avatar - USERDATATYPEDISPLAY: Display Name sh…
HubEventRevokeMessage
object
3 properties3 required
UrlEmbed
object
1 property1 required
IdRegisterEventBody
object
4 properties4 required
StorageRentEventBody
object
3 properties3 required
OnChainEventSigner
MessageDataCommon
object
Common properties shared by all Farcaster message types. These properties provide essential metadata about the message's origin, timing, and network context.
4 properties3 required
UserDataBody
object
Contains the data for updating a specific field of a user's profile metadata. Each update operation modifies one profile field at a time, allowing granular con…
2 properties2 required
IdRegisterEventType
string
FidSchema
integer
Farcaster ID (FID). A unique identifier assigned to each user in the Farcaster network. This number is permanent and cannot be changed. FIDs are assigned seque…
ReactionBody
object
Specifies the details of a reaction to content on Farcaster. A reaction must specify its type (like/recast) and either a target cast ID or URL to react to. Onl…
3 properties1 required
Message
A Message is a delta operation on the Farcaster network that represents a state change. Messages are the fundamental unit of data in Farcaster and can represen…
Embed
FarcasterNetwork
string
Farcaster network the message is intended for. - FARCASTERNETWORKMAINNET: Public primary network - FARCASTERNETWORKTESTNET: Public test network - FARCASTERNETW…
SignatureScheme
string
Type of signature scheme used to sign the Message hash - SIGNATURESCHEMEED25519: Ed25519 signature (default) - SIGNATURESCHEMEEIP712: ECDSA signature using EIP…
RevokeMessageBody
object
1 property1 required
MessageDataFrameAction
Represents a user's interaction with a Farcaster Frame, which is an interactive element embedded within a cast. Frames allow users to engage with content throu…
CastHash
string
A unique hash that identifies a specific cast within the creator's posts. Generated using HASHSCHEMEBLAKE3 of the cast's content.
OnChainEventStorageRent
HubEventPruneMessage
object
3 properties3 required
MessageDataCastRemove
Represents a request to remove (delete) a previously created cast. Only the original creator of a cast can remove it.
MessageDataUserDataAdd
Represents a message that updates a user's profile metadata. This can include changes to profile picture, display name, bio, URL, or preferred username. Each u…
SignerEventType
string
MessageCommon
object
5 properties5 required
MessageDataVerificationRemove
Represents a message that removes an existing blockchain address verification from a user's profile. This allows users to disassociate previously verified addr…
CastEmbed
object
1 property1 required
FrameActionBody
object
Contains the data for a user's interaction with a Farcaster Frame. Frames are interactive elements within casts that can have up to 4 clickable buttons, allowi…
3 properties3 required
HubEventMergeMessage
object
3 properties3 required
ReactionType
string
Type of interaction a user can have with content on the Farcaster network. - Like: Express appreciation for the target content. Similar to "likes" or "favorite…
MergeMessageBody
object
2 properties2 required
PruneMessageBody
object
1 property1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Neynar HubEvents API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
