Art Blocks

aid: art-blocks
url: https://raw.githubusercontent.com/api-evangelist/art-blocks/refs/heads/main/apis.yml
name: Art Blocks
kind: company
description: 'Art Blocks is the leading on-chain generative art platform where artists deploy deterministic code to Ethereum,
  Arbitrum One, and Base; each token is minted by invoking the script with a unique hash, producing a one-of-a-kind artwork
  stored permanently on-chain. The platform exposes four public API surfaces: a Token API that returns ERC-721 metadata conforming
  to the OpenSea standard, a Generator API that serves an iframe-able live view of each artwork, a Media Proxy API that provides
  static PNG renders, and a Hasura GraphQL API (data.artblocks.io) that gives structured access to on-chain and off-chain
  data including projects, tokens, artists, features, minting configuration, and ownership. Decentralised access is available
  through The Graph subgraph for on-chain-only data across all three networks. An MCP Server with 21 tools enables AI-agent
  integration for querying, minting, and generative script scaffolding.'
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Generative Art
- NFT
- On-Chain Art
- Blockchain
- Ethereum
- Arbitrum
- Base
- GraphQL
- Token Metadata
- Web3
- Smart Contracts
- The Graph
- MCP
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
x-category: NFT
x-tier: 1
x-type: company
apis:
- aid: art-blocks:token-api
  name: Art Blocks Token API
  description: Returns ERC-721 token metadata for any Art Blocks token conforming to the OpenSea metadata standard. The response
    includes the live view URL (Generator) and media proxy URL (static PNG) so integrators can obtain all asset links from
    a single call. Available across Ethereum (chain 1), Arbitrum One (chain 42161), and Base (chain 8453) mainnet, plus Sepolia
    testnet.
  humanURL: https://docs.artblocks.io/developer/token-and-generator-apis/
  baseURL: https://token.artblocks.io
  tags:
  - Token Metadata
  - ERC-721
  - NFT
  - Ethereum
  - Arbitrum
  - Base
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/token-and-generator-apis/
  - type: OpenAPI
    url: openapi/art-blocks-token-api.json
  - url: graphql/art-blocks-graphql.md
    type: GraphQL
- aid: art-blocks:generator-api
  name: Art Blocks Generator API
  description: Returns an iframe-able live view of the generative artwork for a given token. The generator runs the artist's
    script in the browser using the token's deterministic hash as a seed, producing the canonical on-chain artwork output.
    Useful for embedding live artwork in external applications and marketplaces.
  humanURL: https://docs.artblocks.io/developer/token-and-generator-apis/
  baseURL: https://generator.artblocks.io
  tags:
  - Generative Art
  - Live View
  - iframe
  - NFT
  - Ethereum
  - Arbitrum
  - Base
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/token-and-generator-apis/
  - type: OpenAPI
    url: openapi/art-blocks-generator-api.json
- aid: art-blocks:media-proxy-api
  name: Art Blocks Media Proxy API
  description: Serves static PNG renders of Art Blocks token artwork captured by a headless browser. These are the canonical
    static images used on the Art Blocks platform and by NFT marketplaces. Images are accessible at a predictable URL pattern
    keyed by chain ID, contract address, and token ID.
  humanURL: https://docs.artblocks.io/developer/token-and-generator-apis/
  baseURL: https://media-proxy.artblocks.io
  tags:
  - Media
  - Static Image
  - PNG
  - NFT
  - Ethereum
  - Arbitrum
  - Base
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/token-and-generator-apis/
  - type: OpenAPI
    url: openapi/art-blocks-media-proxy-api.json
- aid: art-blocks:graphql-api
  name: Art Blocks GraphQL API (Hasura)
  description: Hasura-backed GraphQL API providing structured access to on-chain and off-chain Art Blocks data including projects,
    tokens, artists, contracts, minter configurations, features, tags, and ownership. All queries support filtering by chain_id
    to scope to Ethereum, Arbitrum One, or Base. Primary tables include projects_metadata, tokens_metadata, contracts_metadata,
    and project_minter_configurations. An interactive Hasura playground is publicly available for ad-hoc exploration. Authentication
    via JWT obtained by signing a message with an Ethereum wallet.
  humanURL: https://docs.artblocks.io/developer/graphql/
  baseURL: https://data.artblocks.io
  tags:
  - GraphQL
  - Projects
  - Tokens
  - Artists
  - Features
  - Minting
  - Ethereum
  - Arbitrum
  - Base
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/graphql/
  - type: GraphQL
    url: https://data.artblocks.io/v1/graphql
  - type: Playground
    url: https://cloud.hasura.io/public/graphiql?endpoint=https://data.artblocks.io/v1/graphql
- aid: art-blocks:subgraph-ethereum
  name: Art Blocks Subgraph — Ethereum
  description: Decentralised subgraph on The Graph Network providing on-chain-only data for Art Blocks tokens, projects, and
    ownership on Ethereum mainnet. Uses camelCase field names and the base entity names (without _metadata suffix). Requires
    a developer API key from The Graph Studio.
  humanURL: https://thegraph.com/explorer/subgraphs/6bR1oVsRUUs6czNiB6W7NNenTXtVfNd5iSiwvS4QbRPB
  baseURL: https://gateway-arbitrum.network.thegraph.com
  tags:
  - GraphQL
  - Subgraph
  - The Graph
  - Ethereum
  - On-Chain
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/token-and-generator-apis/
  - type: GraphQL
    url: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/6bR1oVsRUUs6czNiB6W7NNenTXtVfNd5iSiwvS4QbRPB
  - type: Explorer
    url: https://thegraph.com/explorer/subgraphs/6bR1oVsRUUs6czNiB6W7NNenTXtVfNd5iSiwvS4QbRPB
- aid: art-blocks:subgraph-arbitrum
  name: Art Blocks Subgraph — Arbitrum One
  description: Decentralised subgraph on The Graph Network providing on-chain-only data for Art Blocks tokens, projects, and
    ownership on Arbitrum One. Requires a developer API key from The Graph Studio.
  humanURL: https://thegraph.com/explorer/subgraphs/5WwGsBwJ2hVBpc3DphX4VHVMsoPnRkVkuZF4HTArZjCm
  baseURL: https://gateway-arbitrum.network.thegraph.com
  tags:
  - GraphQL
  - Subgraph
  - The Graph
  - Arbitrum
  - On-Chain
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/token-and-generator-apis/
  - type: GraphQL
    url: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5WwGsBwJ2hVBpc3DphX4VHVMsoPnRkVkuZF4HTArZjCm
  - type: Explorer
    url: https://thegraph.com/explorer/subgraphs/5WwGsBwJ2hVBpc3DphX4VHVMsoPnRkVkuZF4HTArZjCm
- aid: art-blocks:subgraph-base
  name: Art Blocks Subgraph — Base
  description: Decentralised subgraph on The Graph Network providing on-chain-only data for Art Blocks tokens, projects, and
    ownership on Base. Requires a developer API key from The Graph Studio.
  humanURL: https://thegraph.com/explorer/subgraphs/5gKxDMnBjv3ffBJ4r3zWD6VrpaYHiq9aUth39YCQXWEt
  baseURL: https://gateway-arbitrum.network.thegraph.com
  tags:
  - GraphQL
  - Subgraph
  - The Graph
  - Base
  - On-Chain
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/token-and-generator-apis/
  - type: GraphQL
    url: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5gKxDMnBjv3ffBJ4r3zWD6VrpaYHiq9aUth39YCQXWEt
  - type: Explorer
    url: https://thegraph.com/explorer/subgraphs/5gKxDMnBjv3ffBJ4r3zWD6VrpaYHiq9aUth39YCQXWEt
- aid: art-blocks:mcp-server
  name: Art Blocks MCP Server
  description: Model Context Protocol server exposing 21 tools for AI agents to interact with the Art Blocks ecosystem across
    Ethereum, Arbitrum, and Base. Tools cover discovering projects, exploring artist portfolios, checking mint eligibility,
    building and submitting mint transactions, exploring table schemas, constructing and executing GraphQL queries, and scaffolding
    generative art scripts. Uses OAuth 2.1 with Dynamic Client Registration; supports Authorization Code + PKCE for browser
    clients and Device Authorization flow for headless agents.
  humanURL: https://docs.artblocks.io/developer/mcp-server/quick-start/
  baseURL: https://mcp.artblocks.io
  tags:
  - MCP
  - AI Agent
  - GraphQL
  - Minting
  - Generative Art
  - OAuth
  - Ethereum
  - Arbitrum
  - Base
  properties:
  - type: Documentation
    url: https://docs.artblocks.io/developer/mcp-server/quick-start/
  - type: MCP
    url: https://mcp.artblocks.io/mcp
  - type: Skills
    url: https://docs.artblocks.io/developer/mcp-server/skills/
  - type: Capabilities
    url: https://docs.artblocks.io/developer/mcp-server/capabilities/
common:
- type: Website
  url: https://www.artblocks.io
- type: Documentation
  url: https://docs.artblocks.io
- type: GitHubOrganization
  url: https://github.com/ArtBlocks
- type: Twitter
  url: https://x.com/artblocks_io
- type: Discord
  url: https://discord.gg/artblocks
- type: Plans
  url: plans/art-blocks-plans.yml
- type: RateLimits
  url: rate-limits/art-blocks-rate-limits.yml
- type: FinOps
  url: finops/art-blocks-finops.yml
- type: JSONLD
  url: json-ld/art-blocks.json
- type: Blog
  url: blogs/blogs.json
integrations:
- name: Ethereum
- name: Arbitrum One
- name: Base
- name: The Graph
- name: Hasura
- name: OpenSea
- name: Cursor
- name: Claude Code
- name: Claude Desktop
- name: ChatGPT
- name: Windsurf
- name: Codex
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com