optimnow-io Pricing API

openapi: 3.2.0
info:
  title: OptimToken Public Pricing API
  version: '2.7'
  x-schema-versions:
    /api/llm-models: '2.7'
    /api/pricing: '1.3'
  description: 'Free, no-auth JSON API behind optimtoken.optimnow.io. Compare LLM API pricing (incl. batch and prompt-cache rates, Arena ELO quality scores) and cloud compute instance pricing across 7 providers.


    Field provenance is marked in each description: [published] = taken directly from the provider/source API; [derived] = computed from published values with a documented formula; [estimated] = curated fallback value, not a quote.


    info.version is the schemaVersion of /api/llm-models; /api/pricing is versioned separately (x-schema-versions), and each response states its own in meta.schemaVersion.


    Licence: the data is published under Creative Commons Attribution 4.0 (CC BY 4.0). When you use it, cite https://optimtoken.optimnow.io/ as the source. Data is provided as-is for comparison purposes; verify final numbers with official provider pricing pages.'
  contact:
    name: OptimNow
    url: https://www.optimnow.io/contact
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://optimtoken.optimnow.io
tags:
- name: Pricing
paths:
  /api/pricing:
    get:
      operationId: listComputeInstances
      summary: Cloud compute instance pricing
      description: 'VM/instance pricing for AWS, Azure, GCP, DigitalOcean, OCI, OVH, and Alibaba Cloud. Live provider APIs where available (see meta.sources), refreshed at most every 24h. Check meta.sourceRegions: some providers'' public endpoints return a global list price regardless of the selected region. Any other spelling of a query than the canonical one (an unknown parameter, another order or case: parameters in the order region, os, provider, instanceType, limit, provider names lower case) is answered with a 308 redirect to the canonical URL, so follow redirects.'
      parameters:
      - name: region
        in: query
        schema:
          type: string
          enum:
          - us-east
          - us-west
          - europe
          - asia-pacific
          default: us-east
        description: 'Pricing region. Live providers (AWS, Azure, GCP) are priced in the mapped provider region; static providers are estimated from US East with a regional multiplier: see meta.sourceRegions for the truth per provider.'
      - name: provider
        in: query
        schema:
          type: string
        description: Comma-separated provider list, case-insensitive (e.g. aws,gcp).
      - name: instanceType
        in: query
        schema:
          type: string
        description: Case-insensitive substring match on the instance type (e.g. 't4g', 'D2s').
      - name: os
        in: query
        schema:
          type: string
          enum:
          - Linux
          - Windows
        description: Case-insensitive operating-system filter, applied before limit. Roughly 41% of the full response is Windows rows, so ask for one OS if you only need one. An unrecognised value is ignored and the whole catalogue is returned.
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
        description: Maximum number of instances returned, applied after filters. Without it the response can exceed 6,000 rows.
      responses:
        '200':
          description: Instance list
          content:
            application/json:
              schema:
                type: object
                properties:
                  instances:
                    type: array
                    items:
                      $ref: '#/components/schemas/ComputeInstance'
                  meta:
                    $ref: '#/components/schemas/PricingMeta'
      tags:
      - Pricing
components:
  schemas:
    PricingMeta:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    ComputeInstance:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true