Skip to main content

Introduction

The ZORA API makes it easy to retrieve NFT metadata, monitor on-chain events, and analyze on-chain sales activity.

note

You can test out the API without needing a key. It’s free to use right now

API Endpoint: https://api.zora.co/graphql

SDK: A development kit to use the API without needing to know GraphQL

NFT Hooks: A tool that makes NFT data retrieval even easier than the ZDK

Key Features#

  • Sales info from on-chain marketplaces (ZORA, OpenSea, LooksRare etc.)
  • Data on every Ethereum NFT contract (Transfers, Mints, etc.)
  • Media is encoded to provide assets at different sizes
  • Automatically syncs newly deployed NFT contracts
  • Fill orders made on OpenSea (Seaport)
  • Text-based search for discoverability
  • And much more

Supported Networks#

The API is expanding to more networks and currently supports:

NetworkChainIdStatus
ETH Mainnet1Entire History
Goerli5Tip of Chain
ZORA7777777Entire History
ZORA Goerli999Entire History
Base8453Entire History
Base Goerli84531Entire History
Optimism10Entire History
Optimism Goerli420Entire History

Getting Started#

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 ERC-721 NFTs
  • Maximum page size limit is 500 for regular queries and 50 for text-based searches
  • Check out the guides section to begin building

Authentication#

Anyone can use the API without an API key as long as the application is making less than 120 requests per minute.

NeedsAPI Key Requirements
Less than 120 requests per minuteNo Key Needed
Greater than 120 requests per minuteKey Needed

You can get an API key here if your needs require greater than 120 requests per minute. To access the API with a key, add a header in your requests with the key X-API-KEY .

headers={"X-API-KEY": <your_api_key>}

Example Collections#

Here are a few NFT contract addresses to test the API with:

  • Zorbs: 0xCa21d4228cDCc68D4e23807E5e370C07577Dd152
  • Monarchs: 0xc729Ce9bF1030fbb639849a96fA8BBD013680B64
  • Crypto Dickbutts: 0x42069ABFE407C60cf4ae4112bEDEaD391dBa1cdB