# API Overview

An overview of the current Art Blocks APIs.

Quick Links:

Token API
Generator API
Media Proxy API
Art Blocks Subgraph
GraphQL API

# Supported Networks

Art Blocks is currently deployed on the following networks:

Network	Chain ID
Ethereum	`1`
Arbitrum One	`42161`
Base	`8453`

All hosted APIs below follow a multichain URL pattern using the chain ID to specify the target network.

# Hosted APIs

# Token API

Provides the token metadata for a given Art Blocks token.

Production

Pattern	Example
`https://token.artblocks.io/{chainID}/{contractAddress}/{tokenID}`	https://token.artblocks.io/1/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/385000000

Staging (Sepolia testnet)

Pattern
`https://token.staging.artblocks.io/{chainID}/{contractAddress}/{tokenID}`

# Generator API

Provides an i-frame-able live-view for the art associated with a given Art Blocks token.

Production

Pattern	Example
`https://generator.artblocks.io/{chainID}/{contractAddress}/{tokenID}`	https://generator.artblocks.io/1/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/385000000

Staging (Sepolia testnet)

Pattern
`https://generator.staging.artblocks.io/{chainID}/{contractAddress}/{tokenID}`

# Media Proxy API

Provides a static snapshot of the rendered live-view for a given Art Blocks token.

Production

Pattern	Example
`https://media-proxy.artblocks.io/{chainID}/{contractAddress}/{tokenID}.png`	https://media-proxy.artblocks.io/1/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/385000000.png

Staging (Sepolia testnet)

Pattern
`https://media-proxy.staging.artblocks.io/{chainID}/{contractAddress}/{tokenID}.png`

Please note that the Generator API and Media Proxy API links for a given token are included in the token response for that token from the Token API.

# Art Blocks Subgraph

Art Blocks has subgraphs deployed to The Graph Network for every supported production network.

These subgraphs can be used to query for on-chain data related to the Art Blocks contracts, including token data and project data. They provide a way to access on-chain data in a more efficient and user-friendly way than directly querying the blockchain, while keeping infrastructure decentralized, transparent, and reliable.

The Art Blocks subgraph is developed in public, and all source code and development activity can be found in the Art Blocks subgraph repository.

# Ethereum Mainnet

Explorer Page
Graphql Endpoint: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/6bR1oVsRUUs6czNiB6W7NNenTXtVfNd5iSiwvS4QbRPB

# Arbitrum One

Explorer Page
Graphql Endpoint: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5WwGsBwJ2hVBpc3DphX4VHVMsoPnRkVkuZF4HTArZjCm

# Base

Explorer Page
Graphql Endpoint: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5gKxDMnBjv3ffBJ4r3zWD6VrpaYHiq9aUth39YCQXWEt

# Helpful Resources

# Querying the Subgraph

The Art Blocks subgraphs can be queried at any of the graphql endpoints listed in the previous section. For richer context — including off-chain data and minter configuration details — we recommend using the Art Blocks GraphQL API.

# GraphQL API

Provides a broader set of data than the subgraph alone — this includes both on-chain and off-chain data. We recommend using this API for most integrations, as it provides a more complete picture of projects, tokens, and minting configurations.

Environment	URL
Production	`https://data.artblocks.io/v1/graphql`
Staging (Sepolia testnet)	`https://ab-staging-sepolia.hasura.app/v1/graphql`

The GraphQL API uses _metadata table suffixes (e.g. projects_metadata, tokens_metadata, contracts_metadata, minters_metadata) and provides fields such as chain_id, contract_address, minter configuration details, and more. See the Entities page for a full reference.

You can use this interactive Hasura playground to explore the full schema and test out queries: https://cloud.hasura.io/public/graphiql?endpoint=https://data.artblocks.io/v1/graphql