The ZORA API makes it easy to retrieve NFT metadata, monitor on-chain events, analyze sales activity, and so much more.
- Data on every Ethereum NFT contract and its associated events (Transfers, Mints, etc.)
- Sales data from every marketplace (ZORA, OpenSea, LooksRare, Foundation, etc.)
- Media is encoded to provide assets at different sizes
- Automatically syncs newly deployed NFT contracts
- Adaptable to any chain and token standard
- Text-based search for discoverability
- Built with GraphQL
- ENS compatible
If you are unfamiliar with GraphQL, we recommend that you check out this resource. In addition, here are a few considerations before using the API.
- The ZDK and NFT Hooks allows anyone to build top on of the API without needing to know GraphQL.
- Currently supports any
- Maximum page size limit is
500for regular queries and
50for text-based searches
- Expanding to other chains and tokens standards soon
- Check out the guides section to begin building
Anyone can use the API without an API key as long as the application is making less than 30 requests per minute.
|Needs||API Key Requirements|
|less than 30 requests per minute||No Key Needed|
|greater than 30 requests per minute||Key Needed|
Direct message @ZORAEngineering on Twitter for an API key if your needs require greater than 30 requests per mintue.
To access the API with a key, add a header in your requests with the key
Here are a few NFT contract addresses to test the API with:
Crypto Dickbutts: 0x42069ABFE407C60cf4ae4112bEDEaD391dBa1cdB
This section provides an overview of how to use GraphiQL to test the API.
The explorer allows anyone to quickly view the different queries. To access the explorer, click on the "Explorer" button at the top.
You will then see a pop-out on the left side of the screen. This section will show all the queries along with their parameters. GraphiQL will populate the queries into the sandbox if you click on them.
It is recommended that the response be formatted by clicking into the nodes section and selecting what should be returned.
The Docs section of GraphiQL can be accessed by clicking on "Docs" in the top left of the page.
Clicking on "Root Query" will display the types for both the arguments and the responses.