> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Graffiti wall pixels

> Retrieve pixels painted on the community graffiti wall within a rectangular area and a slot range. Coordinates are expressed in pixels with the origin at the top-left corner (x = 0, y = 0). Boundary coordinates are inclusive.
If you do not provide a slot, the service returns pixels from the most recent 10,000 slots. You can expand the time window by setting `slot` (end of range) and optionally `startSlot` (start of range). When `startSlot` is omitted, it defaults to `slot - 10000`.
Use `summarize=true` to receive only the final color per pixel within the requested slot range (end state). When `summarize=false` or omitted, the API returns the full sequence of changes within the range.



## OpenAPI

````yaml /api/v1/bundled.yaml get /api/v1/graffitiwall
openapi: 3.0.4
info:
  title: beaconcha.in API Documentation
  license:
    name: GPL-3.0
    url: https://www.gnu.org/licenses/gpl-3.0.en.html
  description: >-
    > ⚠️ No new features or endpoints will be added to V1. We recommend the [V2
    API](/api/overview) for all new projects. See the [migration
    guide](/api/v1-to-v2-migration).

    ## Introduction

    **Advanced and reliable API for accessing comprehensive Ethereum blockchain
    data.**


    - **Free Usage Policy:** The API is free to use under a fair use policy,
    with rate limits of 10 requests per minute per IP.

    - **Caching:** All responses are cached for 1 minute.

    - **Higher Usage Plans:** For higher usage plans, visit:
    [https://beaconcha.in/pricing](https://beaconcha.in/pricing). An API key is
    required to use these plans.


    ### API Key Usage

    API keys can be obtained at
    [/user/settings](https://beaconcha.in/user/settings) and must be included in
    requests either as a query string parameter or in the request header.


    #### Example: Query String Parameter

    ```bash

    curl https://beaconcha.in/api/v1/slot/1?apikey=<your_key>

    ```


    #### Example: Request Header

    ```bash

    curl -H 'apikey: <your_key>' https://beaconcha.in/api/v1/slot/1

    ```
  contact: {}
  version: '1.1'
servers:
  - url: https://beaconcha.in
    description: Ethereum mainnet
  - url: https://hoodi.beaconcha.in
    description: Hoodi Ethereum testnet
security:
  - ApiKeyAuthQuery: []
  - ApiKeyAuthHeader: []
tags:
  - name: Epoch
    description: Data related to consensus layer epochs
  - name: Slots
    description: Data related to consensus layer slots
  - name: Validators
    description: Data related to consensus layer validators
  - name: Rewards
    description: Data related to validator rewards
  - name: Sync Committees
    description: Data related to sync committees
  - name: Rocketpool
    description: Data related to the rocketpool protocol
  - name: ETH.Store®
    description: Data related to the ETH.Store® metric
  - name: Validator deposits
    description: Data related to execution layer validator deposits
  - name: Blocks
    description: Data related to execution layer blocks
  - name: Gas
    description: Data related to gas prices
  - name: Address
    description: Data related to ethereum addresses
  - name: Network
    description: Network data
  - name: Misc
    description: Miscellaneous data
  - name: User
    description: User data
  - name: Machine Metrics
    description: Submit machine, beacon-node, and validator-client monitoring metrics
paths:
  /api/v1/graffitiwall:
    get:
      tags:
        - Misc
      summary: Graffiti wall pixels
      description: >-
        Retrieve pixels painted on the community graffiti wall within a
        rectangular area and a slot range. Coordinates are expressed in pixels
        with the origin at the top-left corner (x = 0, y = 0). Boundary
        coordinates are inclusive.

        If you do not provide a slot, the service returns pixels from the most
        recent 10,000 slots. You can expand the time window by setting `slot`
        (end of range) and optionally `startSlot` (start of range). When
        `startSlot` is omitted, it defaults to `slot - 10000`.

        Use `summarize=true` to receive only the final color per pixel within
        the requested slot range (end state). When `summarize=false` or omitted,
        the API returns the full sequence of changes within the range.
      operationId: getGraffitiWall
      parameters:
        - name: startx
          in: query
          description: >-
            Inclusive start X coordinate (>= 0). If omitted, the full X range is
            used.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 0
        - name: starty
          in: query
          description: >-
            Inclusive start Y coordinate (>= 0). If omitted, the full Y range is
            used.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 0
        - name: endx
          in: query
          description: >-
            Inclusive end X coordinate (>= startx). If omitted, the full X range
            is used.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 511
        - name: endy
          in: query
          description: >-
            Inclusive end Y coordinate (>= starty). If omitted, the full Y range
            is used.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 511
        - name: startSlot
          in: query
          description: >-
            Start of the slot range (inclusive). Defaults to `slot - 10000` when
            omitted.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 12754598
        - name: slot
          in: query
          description: >-
            End of the slot range (inclusive). Defaults to the latest processed
            slot when omitted.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            minimum: 0
            example: 12764598
        - name: summarize
          in: query
          description: >-
            When true, return only the final state for each pixel within the
            requested rectangle and slot range. When false (default), return
            every change to pixels within the range.
          required: false
          style: form
          explode: true
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: >-
            Pixels were retrieved successfully. The `data` array contains one
            entry per painted pixel event (or one per pixel when
            `summarize=true`).
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/types.ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/types.GraffitiwallResponse'
        '400':
          description: >-
            The request is invalid (for example, coordinates out of bounds or
            malformed slot parameters).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.ApiErrorResponse'
              examples:
                invalidArea:
                  summary: Invalid coordinate rectangle
                  value:
                    status: 'ERROR: invalid area coordinates'
                    data: null
                invalidSlot:
                  summary: Invalid slot parameters
                  value:
                    status: 'ERROR: invalid slot parameter'
                    data: null
        '500':
          description: An unexpected server error occurred while processing your request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.ApiErrorResponse'
              examples:
                serverError:
                  summary: Internal error
                  value:
                    status: 'ERROR: internal server error'
                    data: null
components:
  schemas:
    types.ApiResponse:
      type: object
      description: Standard success envelope used by all API endpoints.
      properties:
        status:
          type: string
          description: >-
            HTTP-independent status of the API operation. For successful
            responses this is always "OK".
          enum:
            - OK
        data:
          description: Response payload specific to the endpoint.
          nullable: true
          x-omitempty: true
    types.GraffitiwallResponse:
      type: object
      description: >-
        One painted pixel on the graffiti wall, including coordinates, color,
        and provenance.
      properties:
        x:
          type: integer
          description: >-
            X coordinate of the pixel (>= 0). The origin (0,0) is the top-left
            corner of the canvas.
          minimum: 0
          example: 203
        'y':
          type: integer
          description: >-
            Y coordinate of the pixel (>= 0). The origin (0,0) is the top-left
            corner of the canvas.
          minimum: 0
          example: 420
        color:
          type: string
          description: >-
            RGB color encoded as a 6-character uppercase hexadecimal string
            without a leading '#'.
          pattern: ^[A-F0-9]{6}$
          example: C3423F
        slot:
          type: integer
          description: Beacon chain slot number at which this pixel was painted.
          minimum: 0
          example: 12764598
        validator:
          type: integer
          description: >-
            Index of the validator who painted the pixel (the block proposer for
            the corresponding slot).
          minimum: 0
          example: 1843949
    types.ApiErrorResponse:
      type: object
      description: Standard error envelope returned when a request fails.
      properties:
        status:
          type: string
          description: >-
            Human-readable error indicator and message. The value begins with
            "ERROR:" followed by details.
          example: 'ERROR: <Message>'
        data:
          type: string
          description: Optional additional context for the error. Null in most cases.
          nullable: true
          default: null
  securitySchemes:
    ApiKeyAuthQuery:
      type: apiKey
      in: query
      name: apikey
      description: ''
    ApiKeyAuthHeader:
      type: apiKey
      in: header
      name: apikey
      description: ''

````