{"openapi":"3.0.0","info":{"title":"Token Barometer API","version":"1.0.0","description":"Read-only JSON API for LLM token prices, tracked over time across vendors and hosts. CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attribution is required; a link back to the page you got the data from on tokenbarometer.com is appreciated but not enforced."},"servers":[{"url":"https://tokenbarometer.com/api/v1"}],"components":{"schemas":{"ModelSummary":{"type":"object","properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"vendorSlug":{"type":"string"},"family":{"type":"string"},"tier":{"type":"string","nullable":true},"openWeights":{"type":"boolean"},"contextWindow":{"type":"number","nullable":true},"maxOutputTokens":{"type":"number","nullable":true},"status":{"type":"string"},"cheapest":{"$ref":"#/components/schemas/OfferingSummary"},"vendorDirect":{"$ref":"#/components/schemas/OfferingSummary"}},"required":["slug","displayName","vendorSlug","family","tier","openWeights","contextWindow","maxOutputTokens","status","cheapest","vendorDirect"]},"OfferingSummary":{"type":"object","nullable":true,"properties":{"offeringId":{"type":"integer"},"hostSlug":{"type":"string"},"variant":{"type":"string"},"region":{"type":"string","nullable":true},"sourceSlug":{"type":"string","nullable":true},"confidence":{"type":"string","nullable":true},"validFrom":{"type":"string","nullable":true},"inputMicro":{"type":"number","nullable":true},"inputUsd":{"type":"string","nullable":true},"outputMicro":{"type":"number","nullable":true},"outputUsd":{"type":"string","nullable":true},"cacheReadMicro":{"type":"number","nullable":true},"cacheReadUsd":{"type":"string","nullable":true},"cacheWriteMicro":{"type":"number","nullable":true},"cacheWriteUsd":{"type":"string","nullable":true}},"required":["offeringId","hostSlug","variant","region","sourceSlug","confidence","validFrom","inputMicro","inputUsd","outputMicro","outputUsd","cacheReadMicro","cacheReadUsd","cacheWriteMicro","cacheWriteUsd"]},"ModelDetail":{"type":"object","properties":{"slug":{"type":"string"},"displayName":{"type":"string"},"vendorSlug":{"type":"string"},"family":{"type":"string"},"tier":{"type":"string","nullable":true},"openWeights":{"type":"boolean"},"contextWindow":{"type":"number","nullable":true},"maxOutputTokens":{"type":"number","nullable":true},"status":{"type":"string"},"releaseDate":{"type":"string","nullable":true},"deprecationDate":{"type":"string","nullable":true},"paramsTotalB":{"type":"number","nullable":true},"paramsActiveB":{"type":"number","nullable":true},"inputModalities":{"type":"array","nullable":true,"items":{"type":"string"}},"outputModalities":{"type":"array","nullable":true,"items":{"type":"string"}},"tokenizerFamily":{"type":"string","nullable":true},"aliases":{"type":"array","nullable":true,"items":{"type":"string"}},"offerings":{"type":"array","items":{"$ref":"#/components/schemas/ModelOffering"}}},"required":["slug","displayName","vendorSlug","family","tier","openWeights","contextWindow","maxOutputTokens","status","releaseDate","deprecationDate","paramsTotalB","paramsActiveB","inputModalities","outputModalities","tokenizerFamily","aliases","offerings"]},"ModelOffering":{"allOf":[{"$ref":"#/components/schemas/OfferingSummary"},{"type":"object","properties":{"status":{"type":"string"}},"required":["status"]}]},"ErrorResponse":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"string"}},"required":["ok","error"]},"ModelHistoryItem":{"type":"object","properties":{"slug":{"type":"string"},"kind":{"type":"string"},"detectedAt":{"type":"string"},"hostSlug":{"type":"string","nullable":true},"sourceSlug":{"type":"string"},"magnitudeBp":{"type":"number","nullable":true},"diff":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}}},"required":["slug","kind","detectedAt","hostSlug","sourceSlug","magnitudeBp","diff"]},"PaginationMeta":{"type":"object","properties":{"page":{"type":"integer"},"perPage":{"type":"integer"},"total":{"type":"integer"}},"required":["page","perPage","total"]},"OfferingListItem":{"type":"object","properties":{"offeringId":{"type":"integer"},"modelSlug":{"type":"string"},"displayName":{"type":"string"},"vendorSlug":{"type":"string"},"hostSlug":{"type":"string"},"variant":{"type":"string"},"region":{"type":"string","nullable":true},"status":{"type":"string"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"},"sourceSlug":{"type":"string","nullable":true},"confidence":{"type":"string","nullable":true},"validFrom":{"type":"string","nullable":true},"inputMicro":{"type":"number","nullable":true},"inputUsd":{"type":"string","nullable":true},"outputMicro":{"type":"number","nullable":true},"outputUsd":{"type":"string","nullable":true},"cacheReadMicro":{"type":"number","nullable":true},"cacheReadUsd":{"type":"string","nullable":true},"cacheWriteMicro":{"type":"number","nullable":true},"cacheWriteUsd":{"type":"string","nullable":true},"batchInputMicro":{"type":"number","nullable":true},"batchInputUsd":{"type":"string","nullable":true},"batchOutputMicro":{"type":"number","nullable":true},"batchOutputUsd":{"type":"string","nullable":true},"perRequestMicro":{"type":"number","nullable":true},"perRequestUsd":{"type":"string","nullable":true}},"required":["offeringId","modelSlug","displayName","vendorSlug","hostSlug","variant","region","status","firstSeenAt","lastSeenAt","sourceSlug","confidence","validFrom","inputMicro","inputUsd","outputMicro","outputUsd","cacheReadMicro","cacheReadUsd","cacheWriteMicro","cacheWriteUsd","batchInputMicro","batchInputUsd","batchOutputMicro","batchOutputUsd","perRequestMicro","perRequestUsd"]},"OfferingHistoryItem":{"type":"object","properties":{"sourceSlug":{"type":"string"},"validFrom":{"type":"string"},"validTo":{"type":"string","nullable":true},"confidence":{"type":"string"},"inputMicro":{"type":"number","nullable":true},"inputUsd":{"type":"string","nullable":true},"outputMicro":{"type":"number","nullable":true},"outputUsd":{"type":"string","nullable":true},"cacheReadMicro":{"type":"number","nullable":true},"cacheReadUsd":{"type":"string","nullable":true},"cacheWriteMicro":{"type":"number","nullable":true},"cacheWriteUsd":{"type":"string","nullable":true},"batchInputMicro":{"type":"number","nullable":true},"batchInputUsd":{"type":"string","nullable":true},"batchOutputMicro":{"type":"number","nullable":true},"batchOutputUsd":{"type":"string","nullable":true}},"required":["sourceSlug","validFrom","validTo","confidence","inputMicro","inputUsd","outputMicro","outputUsd","cacheReadMicro","cacheReadUsd","cacheWriteMicro","cacheWriteUsd","batchInputMicro","batchInputUsd","batchOutputMicro","batchOutputUsd"]},"Provider":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"isVendor":{"type":"boolean"},"isHost":{"type":"boolean"},"homepageUrl":{"type":"string","nullable":true},"pricingUrl":{"type":"string","nullable":true}},"required":["slug","name","isVendor","isHost","homepageUrl","pricingUrl"]},"ProviderDetail":{"allOf":[{"$ref":"#/components/schemas/Provider"},{"type":"object","properties":{"modelCount":{"type":"integer"},"offeringCount":{"type":"integer"}},"required":["modelCount","offeringCount"]}]},"ChangeItem":{"type":"object","properties":{"slug":{"type":"string"},"kind":{"type":"string"},"detectedAt":{"type":"string"},"modelSlug":{"type":"string","nullable":true},"hostSlug":{"type":"string","nullable":true},"sourceSlug":{"type":"string"},"magnitudeBp":{"type":"number","nullable":true},"diff":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}}},"required":["slug","kind","detectedAt","modelSlug","hostSlug","sourceSlug","magnitudeBp","diff"]},"MetaResponse":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"dataVersion":{"type":"string"},"counts":{"type":"object","properties":{"providers":{"type":"integer"},"models":{"type":"integer"},"offerings":{"type":"integer"},"priceVersions":{"type":"integer"},"changeEvents":{"type":"integer"}},"required":["providers","models","offerings","priceVersions","changeEvents"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceMeta"}},"licence":{"type":"string"},"citation":{"type":"string"}},"required":["ok","dataVersion","counts","sources","licence","citation"]},"SourceMeta":{"type":"object","properties":{"slug":{"type":"string"},"enabled":{"type":"boolean"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true}},"required":["slug","enabled","lastRunAt","lastStatus"]}},"parameters":{}},"paths":{"/models":{"get":{"tags":["models"],"parameters":[{"schema":{"type":"string"},"required":false,"name":"vendor","in":"query"},{"schema":{"type":"string"},"required":false,"name":"tier","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"open_weights","in":"query"},{"schema":{"type":"string"},"required":false,"name":"q","in":"query"}],"responses":{"200":{"description":"Models matching the filters, each with its cheapest canonical offering and vendor-direct offering (if any).","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"$ref":"#/components/schemas/ModelSummary"}}},"required":["ok","data"]}}}}}}},"/models/{vendor}/{model}":{"get":{"tags":["models"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"vendor","in":"path"},{"schema":{"type":"string"},"required":true,"name":"model","in":"path"}],"responses":{"200":{"description":"One model with every active offering across all hosts.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/ModelDetail"}},"required":["ok","data"]}}}},"404":{"description":"No model with this slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/models/{vendor}/{model}/history":{"get":{"tags":["models"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"vendor","in":"path"},{"schema":{"type":"string"},"required":true,"name":"model","in":"path"},{"schema":{"type":"string"},"required":false,"name":"source","in":"query"},{"schema":{"type":"string"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string"},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"change_event rows for this model, newest first.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"$ref":"#/components/schemas/ModelHistoryItem"}}},"required":["ok","data"]}}}},"404":{"description":"No model with this slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/offerings":{"get":{"tags":["offerings"],"parameters":[{"schema":{"type":"string"},"required":false,"name":"host","in":"query"},{"schema":{"type":"string"},"required":false,"name":"model","in":"query"},{"schema":{"type":"string"},"required":false,"name":"vendor","in":"query"},{"schema":{"type":"string"},"required":false,"name":"variant","in":"query"},{"schema":{"type":"string","enum":["input","output","blended"]},"required":false,"name":"sort","in":"query"},{"schema":{"type":"string","enum":["asc","desc"]},"required":false,"name":"order","in":"query"},{"schema":{"type":"string"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string"},"required":false,"name":"per_page","in":"query"}],"responses":{"200":{"description":"Active offerings matching the filters, paginated (max 500 per page).","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"meta":{"$ref":"#/components/schemas/PaginationMeta"},"data":{"type":"array","items":{"$ref":"#/components/schemas/OfferingListItem"}}},"required":["ok","meta","data"]}}}}}}},"/offerings/{id}/history":{"get":{"tags":["offerings"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Every price_version for this offering, oldest first, across all sources.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"$ref":"#/components/schemas/OfferingHistoryItem"}}},"required":["ok","data"]}}}},"404":{"description":"No offering with this id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/providers":{"get":{"tags":["providers"],"responses":{"200":{"description":"Every vendor and host.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}},"required":["ok","data"]}}}}}}},"/providers/{slug}":{"get":{"tags":["providers"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"One provider with model/offering counts.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/ProviderDetail"}},"required":["ok","data"]}}}},"404":{"description":"No provider with this slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/changes":{"get":{"tags":["changes"],"parameters":[{"schema":{"type":"string"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"provider","in":"query"},{"schema":{"type":"string"},"required":false,"name":"since","in":"query"},{"schema":{"type":"string"},"required":false,"name":"page","in":"query"}],"responses":{"200":{"description":"change_event rows, newest first, 50 per page.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"meta":{"$ref":"#/components/schemas/PaginationMeta"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ChangeItem"}}},"required":["ok","meta","data"]}}}}}}},"/changes/{slug}":{"get":{"tags":["changes"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"One change_event by its slug.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/ChangeItem"}},"required":["ok","data"]}}}},"404":{"description":"No change with this slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/meta":{"get":{"tags":["meta"],"responses":{"200":{"description":"Refresh status, row counts, data version and licence/citation text.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaResponse"}}}}}}}}}