GPU Economy API

openapi: 3.1.0
info:
  title: GPU Economy API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 9 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; GPU Economy has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 7
    pages-with-code: 4
    pages-read: 4
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-10'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://gpueconomy.com/methodology
  - https://gpueconomy.com/data
  - https://gpueconomy.com/mcp
  - https://gpueconomy.com/price-index/reproduce
paths:
  /datasets/gpueconomy/cloud-gpu-price-index/resolve/main/receipt-2026-W39.csv:
    get:
      operationId: get_datasets_gpueconomy_cloud_gpu_price_index_resolve_main_receipt_2026_W39_csv
      tags:
      - Datasets
      summary: Reproduce the Cloud GPU Price Index — receipts and the command
      description: Receipt file for week 2026-W39 hosted on Hugging Face.
      x-source: https://gpueconomy.com/price-index/reproduce
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /graphql:
    get:
      operationId: get_graphql
      tags:
      - Graphql
      summary: Methodology — how GPU Economy collects GPU prices
      x-source: https://gpueconomy.com/methodology
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_graphql
      tags:
      - Graphql
      summary: POST /graphql
      x-source: https://gpueconomy.com/methodology
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s https://api.runpod.io/graphql -H ''content-type: application/json'' -d ''{"query":"{ gpuTypes { id securePrice communityPrice
          } }"}'' live · 63 rows — Vast.ai public API endpoint live · 77 rows auction pricing, API only; trimmed floor of the 5 cheapest verified
          single-GPU offers, withheld when the window cannot carry a floor (fewer than 3 offers, or a median over 3x the cheapest ask) Hyperstac'
  /mcp:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: MCP server for cloud GPU prices — GPU Economy
      description: Read‑only Model Context Protocol (MCP) server that returns GPU cloud pricing data via JSON‑RPC calls. No API key or account
        is required.
      x-source: https://gpueconomy.com/mcp
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMcpResponse'
      x-evidence:
        kind: documentation
  /price-index-hourly.csv:
    get:
      operationId: get_price_index_hourly_csv
      tags:
      - Price Index Hourly
      summary: Reproduce the Cloud GPU Price Index — receipts and the command
      description: CSV file containing every hourly point of the price index.
      x-source: https://gpueconomy.com/price-index/reproduce
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /price-index/hourly/2026-W46.csv:
    get:
      operationId: get_price_index_hourly_2026_W46_csv
      tags:
      - Price Index
      summary: Reproduce the Cloud GPU Price Index — receipts and the command
      description: Hourly receipt for week 2026-W46, used to compute the published point for a specific hour.
      x-source: https://gpueconomy.com/price-index/reproduce
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /price-index/receipts/2026-W45.csv:
    get:
      operationId: get_price_index_receipts_2026_W45_csv
      tags:
      - Price Index
      summary: Reproduce the Cloud GPU Price Index — receipts and the command
      description: The receipt for the week of November 2, 2026 is available at this URL.
      x-source: https://gpueconomy.com/price-index/reproduce
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /prices.json:
    get:
      operationId: get_prices_json
      tags:
      - Prices
      summary: GET /prices.json
      x-source: https://gpueconomy.com/data
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl , requests , Node and Go clients are served as they are. The hosting platform, though, refuses Python’s built-in urllib
          when it sends its default agent ( Python-urllib/3.x ): HTTP 403, “error code: 1010”. That check sits above the settings we control,
          so with the standard library, name your client: import json, urllib.request

          req = urllib.request.Request(''https://gpueconomy.com/prices.json'', '
  /v1/landing/pricing:
    get:
      operationId: get_v1_landing_pricing
      tags:
      - Landing
      summary: Methodology — how GPU Economy collects GPU prices
      x-source: https://gpueconomy.com/methodology
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetMcpResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON‑RPC version
        id:
          type: integer
          description: Matches the request id
        result:
          type: object
          description: Tool answer, containing a first‑line sentence, a citation, and rows with fields such as "scraped_at" and "page"
        error:
          type: object
          description: If the request could not be answered
tags:
- name: Datasets
- name: Graphql
- name: Landing
- name: Mcp
- name: Price Index
- name: Price Index Hourly
- name: Prices