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-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
  - 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: [email protected]