Event Search API

Once you've created at least one event indexer, and events indexed by your Graffle company will be available for searching over via the Event Search API.
Your company id is viewable in the top right corner of the projects page in the Graffle management dashboard.
The url for the Event Search API is:
Main Net:{ COMPANY ID }/search
Test Net:{ COMPANY ID }/search
NOTE: Events on Test Net are stored for 3 days before being removed.

Example Response

"id": "068883b1178935195289a4fe910f4adbf4fb2db6ca100fa529506834f2e152ea",
"blockEventData": {
"id": 292,
"price": 25,
"from": "0x886f3aeaf848c535"
"eventDate": "2021-08-19T16:10:06.4281827+00:00",
"flowEventId": "A.d796ff17107bbff6.Marketplace.ForSale",
"flowTransactionId": "599b5aba16ab072dd12a2449521afdbcdc0dcd4a1b4436374dcef7dc58587b4a"
"id": "56abe3770e7520ecbea62efb19422ae886e99b8fa2304a972ec3e71e12fb3713",
"blockEventData": {
"name": "Solitude 2.0",
"artist": "Jos",
"edition": "1 of 1",
"bidder": "0xa9a82c6a04d6df2b",
"price": 25,
"dropId": 21,
"auctionId": 387
"eventDate": "2021-07-29T13:24:35.52458+00:00",
"flowEventId": "A.d796ff17107bbff6.Versus.Bid",
"flowTransactionId": "905e102ce2b4af8dffc0420f52fce833f177467082942713f56306e8d16d6c1b"
All of the following query parameters can be combined together to narrow down your search results.

BlockEventData Query Parameters

Any of the properties in "blockEventData" can be searched against. In the above sample response the following are all valid search parameters:
  • /search?id=292
  • /search?price=25
  • /search?from="0x886f3aeaf848c535"
  • /search?name="Solitude 2.0"
  • /search?artist="Jos"
  • /search?edition="1 of 1"
  • /search?bidder="0xa9a82c6a04d6df2b"
  • /search?price=25
  • /search?dropId=21
  • /search?auctionId=387

Standard Query Parameters

There are also standard query parameters that can be applied regardless of what events you are indexing.
Parameter Name
Your Graffle project id. Will limit results to only events indexed by this project.
Full Flow event type, or a comma delimited list of event types. ex: A.d796ff17107bbff6.Versus.Bid
Transaction id on Flow. Will limit results to only events that occurred within this transaction
DateTimeOffset, limits results to those that occurred after.
DateTimeOffset, limits results to those that occurred before.
Unix seconds timestamp. Will limit results to events that occurred after this timestamp.


You can page through your results using page and pageSize parameters.