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-productions.s3.amazonaws.com/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: Blogs
  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