Neynar Documentation

eventById

Get an event by its IdQuery Parameters

Parameter	Description	Example
event_id	The Hub Id of the event	`event_id=350909155450880`
shard_index	The shard index for the event	`shard_index=1`

Example

curl http://127.0.0.1:3381/v1/eventById?event_id=151622205440&shard_index=1

Response

{
  "type": "HUB_EVENT_TYPE_BLOCK_CONFIRMED",
  "id": 151622205440,
  "blockConfirmedBody": {
    "blockNumber": 9254285,
    "shardIndex": 1,
    "timestamp": 142732801,
    "blockHash": "0x95659381b61ac3cd9fc06e61d9d9c256f8274aaab526cb23ce72856c2017f721",
    "totalEvents": 10
  },
  "blockNumber": 9254285,
  "shardIndex": 1
}

events

Get a page of Hub eventsQuery Parameters

Parameter	Description	Example
from_event_id	An optional Hub Id to start getting events from. Set it to `0` to start from the first event	`from_event_id=350909155450880`
shard_index	Optional shard index to query	`shard_index=1`
stop_id	Optional stop event ID	`stop_id=350909170294785`
pageSize	Optional page size (default: 1000)	`pageSize=100`
pageToken	Optional page token for pagination	`pageToken=DAEDAAAGlQ...`
reverse	Optional reverse order flag	`reverse=true`

Hubs prune events older than 3 days, so not all historical events can be fetched via this API.

Example

curl http://127.0.0.1:3381/v1/events?from_event_id=0

Response

{
  "events": [
    {
      "type": "HUB_EVENT_TYPE_BLOCK_CONFIRMED",
      "id": 151622205440,
      "blockConfirmedBody": {
        "blockNumber": 9254285,
        "shardIndex": 1,
        "timestamp": 142732801,
        "blockHash": "0x95659381b61ac3cd9fc06e61d9d9c256f8274aaab526cb23ce72856c2017f721",
        "totalEvents": 10
      },
      "blockNumber": 9254285,
      "shardIndex": 1
    },
    {
      "type": "HUB_EVENT_TYPE_MERGE_MESSAGE",
      "id": 151622205441,
      "mergeMessageBody": {
        "message": {
          "data": {
            "type": "MESSAGE_TYPE_REACTION_ADD",
            "fid": 310826,
            "timestamp": 142732800,
            "network": "FARCASTER_NETWORK_MAINNET",
            "reactionBody": {
              "type": "REACTION_TYPE_LIKE",
              "targetCastId": {
                "fid": 1026688,
                "hash": "0xa1162b5d59281733daee1bcd3b810c5259f66ee1"
              }
            }
          },
          "hash": "0xfd4e55bb235fec5cad679182a2c926948d95b7cb",
          "hashScheme": "HASH_SCHEME_BLAKE3",
          "signature": "3N0jZHh46/gXa6uZS+jCbw/9eiOti3MyHNODn7cw5xqo7DBa45rixbzG2QNJtnDmF5XJb+q4GNv/eZF+19qQBw==",
          "signatureScheme": "SIGNATURE_SCHEME_ED25519",
          "signer": "0x217a69e523fbcc51643021d78f9a0fc98ac4e56c7418a2825f0870c81a5d18aa"
        },
        "deletedMessages": []
      },
      "blockNumber": 9254285,
      "shardIndex": 1
    }
  ]
}