How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Airstack HubEvents API

The HubEvents API from Airstack — 2 operation(s) for hubevents.

Airstack HubEvents API is one of 14 APIs that Airstack 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 and API documentation.

This API exposes 2 operations across 2 paths, and defines 57 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://hubs.airstack.xyz.

2 operations 2 paths 57 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.airstack.xyz/graphql
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Airstack HubEvents API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-airstack-hubs (ApiKeyAuth). By default, every request must be authenticated.

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
GET
/v1/events
Get a page of Hub events
ListEvents 1 param → 200default
GET
/v1/eventById
Get an event by its ID
GetEventById 1 param → 200default

Schemas 57

The contract defines 57 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.

ErrorResponse
object
6 properties 6 required
CastRemoveBody
object
Removes an existing Cast
1 property 1 required
MessageDataUserDataAdd
CastId
object
Identifier used to look up a Cast
2 properties 2 required
IdRegisterEventType
string
MergeUserNameProofBody
object
4 properties
PruneMessageBody
object
1 property 1 required
MessageDataCommon
object
3 properties 3 required
UserNameType
string
ReactionType
string
Type of Reaction. - REACTIONTYPELIKE: Like the target cast - REACTIONTYPERECAST: Share target cast to the user's audience
UserNameProof
object
6 properties 6 required
HubEventMergeUsernameProof
object
3 properties 3 required
LinkType
string
Type of Link. - follow: Follow another user
MessageDataUsernameProof
StorageRentEventBody
object
3 properties 3 required
MergeMessageBody
object
2 properties 2 required
MessageDataVerificationRemove
OnChainEventIdRegister
UserDataBody
object
Adds metadata about a user
2 properties 2 required
HubEventPruneMessage
object
3 properties 3 required
OnChainEventStorageRent
Embed
OnChainEventCommon
object
9 properties 9 required
SignerEventType
string
OnChainEvent
UserDataType
string
Type of UserData. - USERDATATYPEPFP: Profile Picture for the user - USERDATATYPEDISPLAY: Display Name for the user - USERDATATYPEBIO: Bio for the user - USERDA…
MergeOnChainEventBody
object
1 property 1 required
OnChainEventSigner
OnChainEventSignerMigrated
MessageDataReaction
HashScheme
string
Type of hashing scheme used to produce a digest of MessageData. - HASHSCHEMEBLAKE3: Default scheme for hashing MessageData
MessageCommon
object
5 properties 5 required
LinkBody
object
Adds or removes a Link
3 properties 2 required
SignerMigratedEventBody
object
1 property 1 required
CastAddBody
object
Adds a new Cast
7 properties 5 required
Message
A Message is a delta operation on the Farcaster network. The message protobuf is an envelope that wraps a MessageData object and contains a hash and signature…
MessageDataLink
MessageDataCastRemove
FarcasterNetwork
string
Farcaster network the message is intended for. - FARCASTERNETWORKMAINNET: Public primary network - FARCASTERNETWORKTESTNET: Public test network - FARCASTERNETW…
CastHash
string
VerificationRemoveBody
object
Removes a Verification of any type
1 property 1 required
SignerEventBody
object
5 properties 5 required
RevokeMessageBody
object
1 property 1 required
MessageDataFrameAction
FrameActionBody
object
A Farcaster Frame action
3 properties 3 required
IdRegisterEventBody
object
4 properties 4 required
HubEventRevokeMessage
object
3 properties 3 required
VerificationAddEthAddressBody
object
Adds a Verification of ownership of an Ethereum Address
3 properties 3 required
SignatureScheme
string
Type of signature scheme used to sign the Message hash - SIGNATURESCHEMEED25519: Ed25519 signature (default) - SIGNATURESCHEMEEIP712: ECDSA signature using EIP…
MessageDataCastAdd
HubEventMergeMessage
object
3 properties 3 required
MessageDataVerificationAdd
UrlEmbed
object
1 property 1 required
HubEventMergeOnChainEvent
object
3 properties 3 required
HubEvent
ReactionBody
object
Adds or removes a Reaction from a Cast
3 properties 1 required
CastEmbed
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

airstack-hubevents-api-openapi.yml Raw ↑

Other APIs Airstack publishes across the network.

Airstack GraphQL API
Airstack Casts API
Airstack FIDs API
Airstack Links API
Airstack OnChainEvents API
Airstack Reactions API
Airstack Storage API
Airstack SubmitMessage API
Airstack UserData API
Airstack Usernames API
Airstack ValidateMessage API
Airstack Verifications API
Where this information came from

This is an independent, third-party profile of Airstack 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.