---
title: "Market models (for model and routing)"
method: GET
path: "/api/v1/broker/models"
tags: ["Account & payment", "Routing"]
---

# Market models (for model and routing)

`GET /api/v1/broker/models`

## Request

- Base URL: `https://api.llm-broker.net`
- URL: `https://api.llm-broker.net/api/v1/broker/models`
- Auth: none required

Every model you can name in `model` on POST /api/v1/chat/completions, served by the cheapest eligible provider without harness. Price = customer price in CHF per 1M tokens (incl. our margin); scores = our own measurements per category (0..1, only where measured) — the basis for `routing.min_score`. No key needed.

## Query parameters

- `currency` string
- `type` string

## Response `200`

Market models

- BrokerMarketModels
  - `categories` string[]
  - `data` BrokerMarketModel[], required
    - `capabilities` string[]: Supported by at least one provider
    - `context` integer, nullable: Largest context window (tokens)
    - `id` string, required: Use as model on chat/completions (type chat), images/generations (image), audio/speech (speech) or audio/transcriptions (transcription), videos (video)
    - `name` string
    - `own` boolean: Media rows: our own product (iris, quill)
    - `price` object, required: Cheapest customer price. Chat: input/output per 1M tokens. Media: exactly one of per_image, per_1k_characters, per_minute, per_second (video, default resolution; billed: actual cost)
      - `currency` string
      - `input` string
      - `output` string
      - `per` string
      - `per_1k_characters` string
      - `per_image` string
      - `per_minute` string
      - `per_second` string
    - `providers` integer, required
    - `regions` string[], required
    - `scores` object: Our own measurement per category, 0..1 (absent = not measured)
    - `throughput` number, nullable: tokens/s (best provider)
    - `type` 'image' | 'speech' | 'transcription' | 'video': Only on media rows (`?type=`); chat rows omit it
    - `vendor` string
  - `object` string

## Other responses

- `400`: Unknown currency or type

---

[API](https://skmtc.dev/llm-broker/apis/astrioncore-core-api.md) · [All operations](https://skmtc.dev/llm-broker/apis/astrioncore-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/llm-broker/apis/astrioncore-core-api/revisions/f85835487bf5?raw)