Consume los datos

Referencia de la API

¿Quieres tus datos en TKX? Estás en la página equivocada. Esta página trata de consumir datos de TKX. Si operas un router o agregador (como 0G) y quieres tus precios en los tableros, no llamas a esta API: expones un endpoint estándar y TKX lo recopila automáticamente. → El estándar Open Router · Aparecer en la lista

Todos los endpoints son GET, devuelven JSON, no necesitan clave y se actualizan cada hora. URL base https://tkx.org. Los ejemplos siguientes son respuestas reales, truncadas.

GET/api/v1/rankings.jsonRankings de modelos (top 60)

GET/api/v1/models/{id}.jsonDetalle por modelo

GET/api/v1/providers.jsonTablero de confianza de proveedores

GET/api/v1/aggregators.jsonTablero de enrutadores / agregadores

GET/api/v1/indices.jsonÍndices TTPI + GPU

GET/api/v1/meta.jsonMetadatos de recolección

Rankings

GET/api/v1/rankings.json

Los 60 mejores modelos clasificados por la oferta verificada más barata. Cada entrada lleva la mejor oferta, el número de proveedores, TTFT/TPS/disponibilidad sondeados cuando están disponibles, un spark de precios de 30 días y el arreglo completo de providers.

Solicitud

curl https://tkx.org/api/v1/rankings.json

Respuesta (truncado)

{
  "generatedAt": "2026-07-22T16:07:24.242Z",
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "rankings": [
    {
      "id": "gpt-5.5",
      "name": "gpt-5.5",
      "org": "azure_ai",
      "ctx": 1050000,
      "best": {
        "in": 5,
        "out": 30,
        "blended": 11.25,
        "router": "official",
        "provider": "azure_ai",
        "evidence": "official"
      },
      "avgBlended": 11.25,
      "providerCount": 5,
      "ttft": null,
      "tps": null,
      "uptime": null,
      "spark": [],
      "providers": [
        {
          "router": "official",
          "provider": "azure_ai",
          "in": 5,
          "out": 30,
          "ttft": null,
          "tps": null,
          "uptime": null,
          "evidence": "official"
        }
      ],
      "usage": {
        "tokens": 98987458250,
        "tokensPaid": 98987458250,
        "tokensFree": 0,
        "share": 1.03,
        "rank": 15,
        "usd": 1113608.91,
        "volChgPct": null,
        "spendChgPct": null
      }
    }
  ]
}

Detalle del modelo

GET/api/v1/models/{id}.json

Cada oferta de proveedor para un único modelo canónico, con precios y evidencia.

Parámetro de ruta	Tipo	Descripción
`id`	string	Id canónico del modelo, p. ej. `gpt-oss-120b`

Solicitud

curl https://tkx.org/api/v1/models/gpt-oss-120b.json

Respuesta (truncado)

{
  "generatedAt": "2026-07-06T07:10:53.381Z",
  "attribution": "Data by TKX (https://tkx.org)",
  "model": {
    "id": "claude-3-5-sonnet",
    "name": "claude-3-5-sonnet",
    "org": "snowflake",
    "ctx": 200000,
    "best": {
      "in": 3,
      "out": 15,
      "blended": 6,
      "router": "official",
      "provider": "snowflake",
      "evidence": "official"
    },
    "providerCount": 3,
    "ttft": null,
    "tps": null,
    "uptime": null,
    "spark": [],
    "providers": [
      {
        "router": "official",
        "provider": "snowflake",
        "in": 3,
        "out": 15,
        "ttft": null,
        "tps": null,
        "uptime": null,
        "evidence": "official"
      }
    ]
  }
}

Proveedores

GET/api/v1/providers.json

El tablero de confianza de proveedores: cobertura, número de ofertas, número de veces que gana como el más barato, disponibilidad/latencia mediana (cuando se sondea) y piso de precisión.

Solicitud

curl https://tkx.org/api/v1/providers.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "data": [
    {
      "key": "requesty",
      "name": "requesty",
      "models": 374,
      "offers": 374,
      "bestWins": 306,
      "routers": [
        "requesty"
      ],
      "medUptime": null,
      "upN": 0,
      "medTtft": null,
      "ttftN": 0,
      "medTps": null,
      "evidence": "api",
      "kind": "provider",
      "quant": null,
      "quantN": 0
    }
  ]
}

GET/api/v1/providers/{key}.json

Detalle por proveedor — los modelos que sirve un proveedor y cómo se compara.

Parámetro de ruta	Tipo	Descripción
`key`	string	Clave del proveedor, p. ej. `fireworks`, `0g`

Solicitud

curl https://tkx.org/api/v1/providers/fireworks.json

Respuesta (truncado)

{
  "generatedAt": "2026-07-22T16:07:24.242Z",
  "attribution": "Data by TKX (https://tkx.org)",
  "provider": {
    "key": "0g",
    "name": "0G Compute",
    "models": 17,
    "offers": 17,
    "bestWins": 14,
    "routers": [
      "0g"
    ],
    "medUptime": null,
    "upN": 0,
    "medTtft": null,
    "ttftN": 0,
    "medTps": null,
    "evidence": "api",
    "kind": "web3",
    "quant": null,
    "quantN": 0,
    "items": [
      {
        "id": "qwen3-vl-30b",
        "name": "qwen3-vl-30b",
        "org": "",
        "in": 0.0194,
        "out": 0.1892,
        "ttft": null,
        "tps": null,
        "uptime": null,
        "evidence": "api",
        "router": "0g",
        "isBest": true
      }
    ]
  }
}

Agregadores

GET/api/v1/aggregators.json

El tablero de enrutadores/agregadores: markupPct medido frente al precio de lista, cobertura, disponibilidad mediana, tier (live | listed) y región.

Solicitud

curl https://tkx.org/api/v1/aggregators.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "data": [
    {
      "slug": "openrouter",
      "name": "OpenRouter",
      "kind": "aggregator",
      "url": "https://openrouter.ai",
      "models": 319,
      "offers": 612,
      "markupPct": 0,
      "markupN": 199,
      "medUptime": 99.5547,
      "medTtft": null,
      "evidence": "api",
      "tier": "live",
      "region": "western",
      "note": "",
      "oai": true,
      "trustScore": 90,
      "completeness": 100,
      "breakdown": {
        "coverage": 100,
        "price": 80,
        "reliability": 93,
        "evidence": 80
      },
      "volume24h": {
        "tokens": 9621566458152,
        "usd": 6402826,
        "date": "2026-07-17",
        "stale": true,
        "volChgPct": null,
        "spendChgPct": null
      }
    }
  ]
}

Índices

GET/api/v1/indices.json

El índice de precio de tokens TTPI más los índices spot de GPU (internacional en vivo + nacional curado), cada uno con tamaño de muestra y versión de metodología.

Solicitud

curl https://tkx.org/api/v1/indices.json

Respuesta (truncado)

{
  "generatedAt": "2026-07-22T16:07:24.241Z",
  "methodology": {
    "version": "M-2026.1",
    "url": "https://tkx.org/methodology/"
  },
  "indices": {
    "TTPI": {
      "name": "TKX 词元价格指数",
      "unit": "USD / 1M tokens (completion, median)",
      "value": 1.9,
      "sample": 319
    },
    "TTV-OR": {
      "name": "TKX Token Traded Value (OpenRouter, est.)",
      "unit": "USD / day (est., paid traffic at list rates, 3:1 in:out blend)",
      "value": 6402826,
      "sample": 36,
      "date": "2026-07-17",
      "stale": true,
      "note": "Estimated list-rate value of paid token traffic routed through OpenRouter. Not billed revenue; free-tier traffic excl…"
    }
  },
  "gpu": {
    "international": [
      {
        "gpu": "H200",
        "source": "vast",
        "currency": "USD",
        "priceHr": 4.08,
        "sample": 18,
        "history": []
      }
    ],
    "domestic": [
      {
        "gpu": "RTX 4090",
        "source": "curated snapshot 2026-07-04",
        "currency": "CNY",
        "priceHr": 2.18,
        "sample": 5,
        "history": []
      }
    ]
  },
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution"
}

Cambios

GET/api/v1/changes.json

Eventos de cambio de precio en 24 horas — movimientos del precio blended más barato por modelo por encima del umbral, día a día.

Solicitud

curl https://tkx.org/api/v1/changes.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "generatedAt": "2026-07-22T16:07:24.211Z",
  "window": "24h",
  "events": []
}

GET/api/v1/trending.json

Mayores movimientos en 30 días y aplicaciones en tendencia.

Solicitud

curl https://tkx.org/api/v1/trending.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "generatedAt": "2026-07-22T16:07:24.211Z",
  "topMovers": [],
  "topApps": [
    {
      "title": "Command Code",
      "url": "https://commandcode.ai/",
      "growth": 1431
    }
  ]
}

Aplicaciones

GET/api/v1/apps.json

Tablero de uso de tokens de aplicaciones y agentes, atribuido a OpenRouter.

Solicitud

curl https://tkx.org/api/v1/apps.json

Respuesta (truncado)

{
  "attribution": "App/agent token usage via OpenRouter (openrouter.ai/apps)",
  "generatedAt": "2026-07-22T16:07:24.203Z",
  "source": "OpenRouter",
  "popular": [
    {
      "rank": 2,
      "title": "Hermes Agent",
      "desc": "Hermes Agent is an open-source, self-improving AI agent by Nous Research that runs persistently with memory across se…",
      "slug": "hermes-agent",
      "url": "https://hermes-agent.nousresearch.com/",
      "cats": [
        "personal-agent"
      ],
      "tokens": 28772524995746,
      "requests": 367166827
    }
  ],
  "trending": [
    {
      "rank": 7,
      "title": "Command Code",
      "desc": "",
      "slug": "",
      "url": "https://commandcode.ai/",
      "cats": [
        "programming-app"
      ],
      "tokens": 1273389568214,
      "requests": 37968056,
      "growth": 1431
    }
  ],
  "leaderboards": {
    "coding": [
      {
        "rank": 2,
        "title": "Hermes Agent",
        "desc": "Hermes Agent is an open-source, self-improving AI agent by Nous Research that runs persistently with memory across se…",
        "slug": "hermes-agent",
        "url": "https://hermes-agent.nousresearch.com/",
        "cats": [
          "personal-agent"
        ],
        "tokens": 889819065274,
        "requests": 12846144
      }
    ],
    "creative": [
      {
        "rank": 9,
        "title": "Descript",
        "desc": "AI Video & Podcast Editor",
        "slug": "descript",
        "url": "https://descript.com/",
        "cats": [
          "video-gen"
        ],
        "tokens": 72758705917,
        "requests": 919852
      }
    ],
    "productivity": [
      {
        "rank": 2,
        "title": "Hermes Agent",
        "desc": "Hermes Agent is an open-source, self-improving AI agent by Nous Research that runs persistently with memory across se…",
        "slug": "hermes-agent",
        "url": "https://hermes-agent.nousresearch.com/",
        "cats": [
          "personal-agent"
        ],
        "tokens": 889819065274,
        "requests": 12846144
      }
    ],
    "entertainment": [
      {
        "rank": 12,
        "title": "Hello Minds, powered by Ethoswarm",
        "desc": "",
        "slug": "",
        "url": "https://www.hellominds.ai/",
        "cats": [
          "roleplay"
        ],
        "tokens": 50652424750,
        "requests": 233112
      }
    ]
  }
}

Nubes de GPU

GET/api/v1/gpu-clouds.json

Tabla de precios de proveedores de nube de GPU — instantánea curada más precios spot en vivo de Vast, por tarjeta.

Solicitud

curl https://tkx.org/api/v1/gpu-clouds.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "asof": "2026-07-04",
  "vastLiveAt": "2026-07-22T11:39:11.061Z",
  "clouds": [
    {
      "name": "Vast.ai",
      "url": "https://vast.ai/",
      "region": "spot",
      "cur": "$",
      "p": {
        "4090": 0.369,
        "5090": 0.457,
        "a100": 0.889,
        "h100": 2.235,
        "b200": 7.126
      },
      "tier": "live",
      "note": "竞价市场,最便宜;会被抢占需 checkpoint。TKX 实时抓取此源。"
    }
  ]
}

Historial

GET/api/v1/history/ttpi.json

Historial diario de TTPI (ventana de 30 días).

Solicitud

curl https://tkx.org/api/v1/history/ttpi.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "code": "TTPI",
  "unit": "USD per 1M completion tokens (median)",
  "history": []
}

GET/api/v1/history/gpu.json

Historial diario de precios de GPU por fuente y tarjeta (ventana de 30 días).

Solicitud

curl https://tkx.org/api/v1/history/gpu.json

Respuesta (truncado)

{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "unit": "per GPU-hour (vast=USD live market, curated-cn=CNY curated snapshot)",
  "series": {}
}

Especificación OpenAPI

GET/api/v1/openapi.json

El contrato completo legible por máquina (OpenAPI 3.1). Apunta tu generador de código / Swagger UI a él.

Solicitud

curl https://tkx.org/api/v1/openapi.json

Respuesta (truncado)

{
  "openapi": "3.1.0",
  "info": {
    "title": "TKX Public Data API",
    "version": "1.3.0",
    "description": "The data authority for the AI token & compute market. Free with attribution to tkx.org. All endpoints are static JSON…",
    "contact": {
      "email": "echo@minax.io",
      "url": "https://tkx.org/standard/"
    }
  },
  "servers": [
    {
      "url": "https://tkx.org"
    }
  ],
  "paths": {
    "/api/v1/rankings.json": {
      "get": {
        "summary": "Model rankings: sorted by est. 24h traded value first (usage.usd = paid tokens × list rate; free traffic never priced…",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/models/{id}.json": {
      "get": {
        "summary": "Per-model detail: all provider offers, prices, evidence",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Unknown model"
          }
        }
      }
    },
    "/api/v1/providers.json": {
      "get": {
        "summary": "Provider trust board: coverage, cheapest-wins, uptime/latency medians, precision floor",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/providers/{key}.json": {
      "get": {
        "summary": "Per-provider detail",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/aggregators.json": {
      "get": {
        "summary": "Router board (45 tracked), sorted by 24h token volume first (Deng 2026-07-21: volume is the primary ranking; coverage…",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/indices.json": {
      "get": {
        "summary": "TTPI token price index, TTV-OR est. daily token traded value (paid traffic at list rates), GPU spot indices (intl liv…",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/changes.json": {
      "get": {
        "summary": "24h price-change events (>2% day-over-day per-model cheapest blended)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/trending.json": {
      "get": {
        "summary": "Top movers (30d) and trending apps",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/usage.json": {
      "get": {
        "summary": "Real per-model token usage/share + est. spend (OpenRouter rankings-daily; paid/free split; est. at list rates; OpenRo…",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/apps.json": {
      "get": {
        "summary": "Apps & agents token-usage board (attributed to OpenRouter)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/gpu-clouds.json": {
      "get": {
        "summary": "GPU cloud supplier price table (curated + Vast live)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/history/ttpi.json": {
      "get": {
        "summary": "TTPI daily history (30d window)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/history/gpu.json": {
      "get": {
        "summary": "GPU price daily history by source|card (30d window)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/constituents/ttpi.json": {
      "get": {
        "summary": "TTPI full constituents for today's point + sha256 — recompute/audit the index without database access",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/constituents/ttv-or.json": {
      "get": {
        "summary": "TTV-OR full constituents (per-model est. spend) + sha256 for today's point",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/price-ohlc.json": {
      "get": {
        "summary": "Per-model daily price OHLC (cheapest blended, 90d) — real prices, candles gain intraday range as hourly buckets accum…",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/v1/meta.json": {
      "get": {
        "summary": "Collection metadata: counts, source status incl. aux (dev/apps/gpu)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}

← Anterior

Atribución y límites

Modelo de datos y evidencia

Referencia de la API

Rankings

Detalle del modelo

Proveedores

Agregadores

Índices

Cambios

Tendencias

Aplicaciones

Nubes de GPU

Historial

Meta

Especificación OpenAPI