> ## 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.

# Validate and reserve API quota

> Returns 204 after validating a registered API-KEY and consuming one request from the selected budget. Used by website gateways before cached reads or shared-key forwarding. Not a wallet session or free validation probe.



## OpenAPI

````yaml /api-reference/vibemarket_openapi.json get /api-key
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. Every consumer API request requires a
    registered API-KEY, including public-data reads. Keys are shared across
    Vibechain products and never replace wallet/session authorization. Normal
    per-replica minute budgets are 100 reads, 25 writes and 10 stream
    connections, multiplied by the approved key multiplier. 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:
  - ApiKey: []
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
  - name: API keys
  - name: Shared services
paths:
  /api-key:
    get:
      tags:
        - API keys
      summary: Validate and reserve API quota
      description: >-
        Returns 204 after validating a registered API-KEY and consuming one
        request from the selected budget. Used by website gateways before cached
        reads or shared-key forwarding. Not a wallet session or free validation
        probe.
      operationId: vm2059
      parameters:
        - name: bucket
          in: query
          required: true
          schema:
            type: string
            enum:
              - read
              - write
              - stream
      responses:
        '204':
          description: Key accepted and one request reserved; inspect RateLimit headers.
        '401':
          $ref: '#/components/responses/ApiKeyUnauthorized'
        '429':
          $ref: '#/components/responses/ApiKeyRateLimited'
        '503':
          $ref: '#/components/responses/ApiKeyUnavailable'
      security:
        - ApiKey: []
components:
  responses:
    ApiKeyUnauthorized:
      description: >-
        Missing, malformed or invalid API key; private routes can also reject
        session credentials.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ApiKeyRateLimited:
      description: >-
        API-key budget, failed key attempts or independent service admission
        exhausted. Honor Retry-After.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
    ApiKeyUnavailable:
      description: Key lookup or application dependency unavailable; fails closed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: API-KEY
      description: >-
        Registered Vibechain application key. Required in addition to
        wallet/session credentials. Obtain your own key via POST
        https://build.vibechain.com/apikey/create; see Authentication and
        consent. Missing/invalid keys: 401; exhausted quota: 429; lookup outage:
        503.

````