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

# Read a bounded market batch

> Read 1–100 unique comma-separated positive drop IDs. Compare returned IDs with requested IDs; the response may contain only indexed markets.



## OpenAPI

````yaml /api-reference/vibemarket_openapi.json get /runtime/{version}/markets/batch
openapi: 3.0.3
info:
  title: vibe.market API
  version: '2026-09-10'
  description: >-
    Consumer HTTP API for the current vibe.market at
    https://vibechain.com/market. This is an experimental protocol; review
    https://vibechain.com/terms. Public reads do not require Classic API keys.
    Discover runtime graphs rather than hardcoding a revision. The
    /api/vibemarket2 namespace is intentional. Operational provider webhooks and
    operator-only controls are excluded.
  termsOfService: https://vibechain.com/terms
servers:
  - url: https://build.vibechain.com/api/vibemarket2
    description: Current-market backend
security: []
tags:
  - name: Discovery
  - name: Indexed market
  - name: Board
  - name: Live updates
  - name: Creators
  - name: Artwork
  - name: Accounts
  - name: Community
  - name: Private messages
  - name: Scoped sessions
paths:
  /runtime/{version}/markets/batch:
    get:
      tags:
        - Indexed market
      summary: Read a bounded market batch
      description: >-
        Read 1–100 unique comma-separated positive drop IDs. Compare returned
        IDs with requested IDs; the response may contain only indexed markets.
      operationId: vm2014
      parameters:
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: >-
            Runtime id from /runtime/versions or catalog/sources; never infer
            the newest revision from its name.
        - name: ids
          in: query
          required: true
          schema:
            type: string
          description: Comma-separated positive drop IDs, maximum 100.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  markets:
                    type: array
                    items:
                      $ref: '#/components/schemas/MarketRow'
                  head:
                    $ref: '#/components/schemas/Head'
                required:
                  - markets
                  - head
        '400':
          description: Invalid input, signature, cursor or action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Dependency, projection or capacity unavailable. Retry with backoff.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security: []
components:
  schemas:
    MarketRow:
      type: object
      properties:
        id:
          type: string
          pattern: ^[0-9]+$
          description: >-
            Exact nonnegative integer; parse as BigInt, not a floating-point
            number.
        name:
          type: string
        symbol:
          type: string
        creator:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        token:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        createdTx:
          type: string
        canonicalSlug:
          type: string
      required:
        - id
      description: >-
        Raw indexed market payload. Monetary quantities use decimal strings;
        additional graph-specific fields may evolve.
    Head:
      type: object
      properties:
        scope:
          type: string
        nextBlock:
          type: integer
        blockHash:
          type: string
          nullable: true
        revision:
          type: integer
        updatedAt:
          type: integer
        failure:
          type: string
          nullable: true
        observedHead:
          type: integer
        observedAt:
          type: integer
        webhookAudit:
          type: object
          nullable: true
      required:
        - scope
        - nextBlock
        - blockHash
        - revision
        - updatedAt
        - failure
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error

````