GPUs Market API

openapi: 3.1.0
info:
  title: GPUs Market API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 27 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; GPUs Market has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 13
    documentation: 14
    pages-with-code: 2
    pages-read: 2
  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://gpusmarket.com/docs
  - https://gpusmarket.com/docs/quickstart/cline
servers:
- url: https://relay.gpusmarket.com
paths:
  /api/signup:
    post:
      operationId: post_api_signup
      tags:
      - Api
      summary: POST /api/signup
      x-source: https://gpusmarket.com/docs/quickstart/cline
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiSignupRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiSignupResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://gpusmarket.com/api/signup  -H \"Content-Type: application/json\"  -d '{\"email\":\"you@company.com\",\"\
          tenantId\":\"my-cline-project\",\"role\":\"renter\"}' \n Save the gpu_ token from the response. Add it to your environment: \n Copy\
          \ # Add to your .env or .clinerules \nexport GPUSMARKET_BASE_URL=https://gpusmarket.com\nexport GPUSMARKET_TOKEN=gpu_your_token_here\
          \ \n Already have an account? Log "
  /api/signup/recover:
    post:
      operationId: post_api_signup_recover
      tags:
      - Api
      summary: Sign‑up recover
      description: Recover a GPU token via email.
      x-source: https://gpusmarket.com/docs/quickstart/cline
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiSignupRecoverRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/gpu/cheapest:
    get:
      operationId: get_api_v1_gpu_cheapest
      tags:
      - Api
      summary: Cheapest for VRAM
      description: Find the cheapest GPU meeting VRAM requirement.
      x-source: https://gpusmarket.com/docs/quickstart/cline
      parameters:
      - name: vram
        in: query
        required: false
        schema:
          type: string
        description: Minimum VRAM in GB
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/gpu/deploy:
    post:
      operationId: post_api_v1_gpu_deploy
      tags:
      - Api
      summary: POST /api/v1/gpu/deploy
      x-source: https://gpusmarket.com/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1GpuDeployRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1GpuDeployResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://gpusmarket.com/api/v1/gpu/deploy  -H "Authorization: Bearer gpu_your_key"  -H "Content-Type: application/json"  -d
          ''{"gpuType":"RTX 4090","models":["qwen3:14b","gemma3n:e4b"]}'''
  /api/v1/gpu/pods:
    get:
      operationId: get_api_v1_gpu_pods
      tags:
      - Api
      summary: List cloud GPU pods
      description: List cloud GPU instances. Requires Bearer gpu_ token.
      x-source: https://gpusmarket.com/docs/quickstart/cline
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/gpu/pods/{podid}:
    get:
      operationId: get_api_v1_gpu_pods_podid
      tags:
      - Api
      summary: GET /api/v1/gpu/pods/{podId}
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: podid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1GpuPodsPodidResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://gpusmarket.com/api/v1/gpu/pods/POD_ID  -H "Authorization: Bearer gpu_your_key"'
  /api/v1/gpu/types:
    get:
      operationId: get_api_v1_gpu_types
      tags:
      - Api
      summary: GET /api/v1/gpu/types
      x-source: https://gpusmarket.com/docs
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1GpuTypesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl https://gpusmarket.com/api/v1/gpu/types
  /api/v1/marketplace/rentals:
    get:
      operationId: get_api_v1_marketplace_rentals
      tags:
      - Api
      summary: List rentals
      description: List your active rentals. Requires Bearer gpu_ token.
      x-source: https://gpusmarket.com/docs/quickstart/cline
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: Filter rentals by status (e.g., active)
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/marketplace/search:
    get:
      operationId: get_api_v1_marketplace_search
      tags:
      - Api
      summary: GET /api/v1/marketplace/search
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: gpu
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1MarketplaceSearchResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl https://gpusmarket.com/api/v1/marketplace/search?gpu=RTX4090
  /api/v1/ollama/{rentalId}/api/chat:
    get:
      operationId: get_api_v1_ollama_rentalId_api_chat
      tags:
      - Api
      summary: Chat endpoint for Ollama proxy
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: rentalId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/ollama/{rentalid}:
    post:
      operationId: post_api_v1_ollama_rentalid
      tags:
      - Api
      summary: POST /api/v1/ollama/{rentalId}
      x-source: https://gpusmarket.com/docs/quickstart/cline
      parameters:
      - name: rentalid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1OllamaRentalidResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST $GPUSMARKET_BASE_URL/api/v1/marketplace/rent/LISTING_ID  -H \"Authorization: Bearer $GPUSMARKET_TOKEN\" \n Response\
          \ includes: \n Copy {\n \"rental\": {\n \"_id\": \"68abc123...\",\n \"proxyEndpoint\": \"https://gpusmarket.com/api/v1/ollama/RENTAL_ID\"\
          ,\n \"relayEndpoint\": \"https://relay.gpusmarket.com/proxy/RENTAL_ID\",\n \"apiKey\": \"a1b2c3d4e5f6...\",\n \"status\": \"active\"\
          \n }\n} \n Prefer cloud GPUs? Deploy on"
  /auth/api-key:
    post:
      operationId: post_auth_api_key
      tags:
      - Auth
      summary: Generate an account key from Settings → API Keys or via the API
      description: POST /auth/api-key creates a new API key.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: label
        in: query
        required: true
        schema:
          type: string
        description: Label for the new API key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAuthApiKeyRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /cheapest:
    get:
      operationId: get_cheapest
      tags:
      - Cheapest
      summary: Find cheapest GPU for a VRAM requirement
      description: GET /cheapest returns the cheapest GPU that meets the specified VRAM requirement.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: vram
        in: query
        required: true
        schema:
          type: number
        description: Required VRAM in GB
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /deploy:
    post:
      operationId: post_deploy
      tags:
      - Deploy
      summary: Deploy on-demand GPU instance.
      description: POST /deploy creates a new on‑demand GPU instance.
      x-source: https://gpusmarket.com/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDeployRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDeployResponse'
      x-evidence:
        kind: documentation
  /gpu-models:
    get:
      operationId: get_gpu_models
      tags:
      - Gpu Models
      summary: GPU catalogue summary
      description: GET /gpu-models provides a summary of GPU models with availability and pricing.
      x-source: https://gpusmarket.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /listings/{id}:
    get:
      operationId: get_listings_id
      tags:
      - Listings
      summary: Listing detail + health
      description: GET /listings/:id returns detailed information and health status for a specific listing.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /pods:
    get:
      operationId: get_pods
      tags:
      - Pods
      summary: List your active cloud GPU instances
      description: GET /pods returns a list of the user's active cloud GPU instances.
      x-source: https://gpusmarket.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /pods/{id}:
    delete:
      operationId: delete_pods_id
      tags:
      - Pods
      summary: Destroy instance permanently. Returns final cost
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_pods_id
      tags:
      - Pods
      summary: Instance status + live billing
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /pods/{id}/resume:
    put:
      operationId: put_pods_id_resume
      tags:
      - Pods
      summary: Resume paused instance
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /pods/{id}/stop:
    put:
      operationId: put_pods_id_stop
      tags:
      - Pods
      summary: Pause instance (billing pauses, volume kept)
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /rent/{listingid}:
    post:
      operationId: post_rent_listingid
      tags:
      - Rent
      summary: Rent a GPU. Returns rental ID + proxy API key
      description: POST /rent/:listingId creates a new rental for the specified listing.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: listingid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /rentals:
    get:
      operationId: get_rentals
      tags:
      - Rentals
      summary: List your rentals.
      description: GET /rentals returns a list of the user's rentals.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: Filter rentals by status
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /rentals/{id}:
    get:
      operationId: get_rentals_id
      tags:
      - Rentals
      summary: Rental detail + usage
      description: GET /rentals/:id provides detailed usage information for a specific rental.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /rentals/{id}/stop:
    post:
      operationId: post_rentals_id_stop
      tags:
      - Rentals
      summary: Stop rental. Returns cost summary
      description: POST /rentals/:id/stop stops the specified rental and returns a cost summary.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /search:
    get:
      operationId: get_search
      tags:
      - Search
      summary: Search listings.
      description: GET /search returns listings matching the query parameters.
      x-source: https://gpusmarket.com/docs
      parameters:
      - name: gpu
        in: query
        required: false
        schema:
          type: string
      - name: maxPrice
        in: query
        required: false
        schema:
          type: number
      - name: minVram
        in: query
        required: false
        schema:
          type: number
      - name: ollamaModel
        in: query
        required: false
        schema:
          type: string
      - name: instanceType
        in: query
        required: false
        schema:
          type: string
      - name: pricingTier
        in: query
        required: false
        schema:
          type: string
      - name: sort
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /types:
    get:
      operationId: get_types
      tags:
      - Types
      summary: All GPU types with live pricing (margin included). Returns pricePerHour , vramGb
      description: GET /types lists all GPU types with current pricing information.
      x-source: https://gpusmarket.com/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTypesResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiSignupRequest:
      type: object
      properties:
        email:
          type: string
        tenantId:
          type: string
        role:
          type: string
    PostApiSignupResponse:
      type: object
      properties:
        email:
          type: string
        tenantId:
          type: string
        role:
          type: string
    PostApiSignupRecoverRequest:
      type: object
      properties:
        email:
          type: string
          description: Account email for recovery
      required:
      - email
    PostApiV1GpuDeployRequest:
      type: object
      properties:
        gpuType:
          type: string
        models:
          type: array
          items:
            type: string
    PostApiV1GpuDeployResponse:
      type: object
      properties:
        instance:
          type: object
          properties:
            id:
              type: string
            gpuType:
              type: string
            vramGb:
              type: integer
            pricePerHour:
              type: number
            instanceType:
              type: string
            status:
              type: string
            pricingTier:
              type: string
            startedAt:
              type: string
              format: date-time
    GetApiV1GpuPodsPodidResponse:
      type: object
      properties:
        instance:
          type: object
          properties:
            id:
              type: string
            gpuType:
              type: string
            vramGb:
              type: integer
            pricePerHour:
              type: number
            instanceType:
              type: string
            status:
              type: string
            pricingTier:
              type: string
            startedAt:
              type: string
              format: date-time
    GetApiV1GpuTypesResponse:
      type: object
      properties:
        instance:
          type: object
          properties:
            id:
              type: string
            gpuType:
              type: string
            vramGb:
              type: integer
            pricePerHour:
              type: number
            instanceType:
              type: string
            status:
              type: string
            pricingTier:
              type: string
            startedAt:
              type: string
              format: date-time
    GetApiV1MarketplaceSearchResponse:
      type: object
      properties:
        instance:
          type: object
          properties:
            id:
              type: string
            gpuType:
              type: string
            vramGb:
              type: integer
            pricePerHour:
              type: number
            instanceType:
              type: string
            status:
              type: string
            pricingTier:
              type: string
            startedAt:
              type: string
              format: date-time
    PostApiV1OllamaRentalidResponse:
      type: object
      properties:
        rental:
          type: object
          properties:
            _id:
              type: string
            proxyEndpoint:
              type: string
            relayEndpoint:
              type: string
            apiKey:
              type: string
            status:
              type: string
    PostAuthApiKeyRequest:
      type: object
      properties:
        label:
          type: string
          description: Label for the new API key
      required:
      - label
    PostDeployRequest:
      type: object
      properties:
        gpuType:
          type: string
          description: GPU model to deploy
        models:
          type: array
          description: List of model identifiers
        instanceType:
          type: string
          description: Type of instance (e.g., ollama)
      required:
      - gpuType
      - models
      - instanceType
    PostDeployResponse:
      type: object
      properties:
        instance:
          type: object
          description: Deployed instance details
    GetTypesResponse:
      type: object
      properties:
        pricePerHour:
          type: number
        vramGb:
          type: number
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Auth
- name: Cheapest
- name: Deploy
- name: Gpu Models
- name: Listings
- name: Pods
- name: Rent
- name: Rentals
- name: Search
- name: Types