문서 랭킹 ↗
🌐 한국어
EN简体中文繁體中文EspañolFrançais日本語한국어العربيةPortuguês
데이터 사용하기

API 레퍼런스

!
데이터를 TKX에 올리고 싶나요? 잘못된 페이지입니다. 이 페이지는 TKX 데이터를 사용하는 방법입니다. 라우터나 애그리게이터(예: 0G)를 운영하며 가격을 보드에 올리고 싶다면, 이 API를 호출하지 않습니다 — 표준 엔드포인트를 노출하면 TKX가 자동으로 수집합니다. → Open Router 표준 · 등록하기

모든 엔드포인트는 GET이며, JSON을 반환하고, 키가 필요 없으며, 매시간 갱신됩니다. 기본 URL은 https://tkx.org입니다. 아래 예제는 실제 응답이며, 잘려 있습니다.

GET/api/v1/rankings.json모델 랭킹 (상위 60)
GET/api/v1/models/{id}.json모델별 상세
GET/api/v1/providers.json공급자 신뢰 보드
GET/api/v1/aggregators.json라우터 / 애그리게이터 보드
GET/api/v1/indices.jsonTTPI + GPU 지수
GET/api/v1/meta.json수집 메타데이터

랭킹

GET/api/v1/rankings.json

최저 검증 오퍼로 순위가 매겨진 상위 60개 모델. 각 항목에는 최선의 오퍼, 공급자 수, 가능한 경우 프로브한 TTFT/TPS/가동률, 30일 가격 spark, 그리고 전체 providers 배열이 포함됩니다.

요청
curl https://tkx.org/api/v1/rankings.json
응답 (잘림)
{
  "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
      }
    }
  ]
}

모델 상세

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

단일 정규 모델에 대한 모든 공급자 오퍼로, 가격 및 증거와 함께 제공됩니다.

경로 매개변수유형설명
idstring정규 모델 id, 예: gpt-oss-120b
요청
curl https://tkx.org/api/v1/models/gpt-oss-120b.json
응답 (잘림)
{
  "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"
      }
    ]
  }
}

공급자

GET/api/v1/providers.json

공급자 신뢰 보드: 커버리지, 오퍼 수, 최저가 우승 횟수, (프로브한 경우) 중앙값 가동률/지연 시간 및 정밀도 하한.

요청
curl https://tkx.org/api/v1/providers.json
응답 (잘림)
{
  "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

공급자별 상세 — 공급자가 제공하는 모델과 그것이 어떻게 비교되는지.

경로 매개변수유형설명
keystring공급자 키, 예: fireworks, 0g
요청
curl https://tkx.org/api/v1/providers/fireworks.json
응답 (잘림)
{
  "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
      }
    ]
  }
}

애그리게이터

GET/api/v1/aggregators.json

라우터/애그리게이터 보드: 정가 대비 측정된 markupPct, 커버리지, 중앙값 가동률, 티어(live | listed) 및 지역.

요청
curl https://tkx.org/api/v1/aggregators.json
응답 (잘림)
{
  "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
      }
    }
  ]
}

지수

GET/api/v1/indices.json

TTPI 토큰 가격 지수와 GPU 스팟 지수(국제 라이브 + 국내 선별)로, 각각 표본 크기와 방법론 버전을 포함합니다.

요청
curl https://tkx.org/api/v1/indices.json
응답 (잘림)
{
  "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"
}

변동

GET/api/v1/changes.json

24시간 가격 변동 이벤트 — 임계값을 넘는 모델별 최저 blended 가격의 전일 대비 변동.

요청
curl https://tkx.org/api/v1/changes.json
응답 (잘림)
{
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "generatedAt": "2026-07-22T16:07:24.211Z",
  "window": "24h",
  "events": []
}

앱

GET/api/v1/apps.json

앱 및 에이전트 토큰 사용량 보드로, OpenRouter에 출처를 둡니다.

요청
curl https://tkx.org/api/v1/apps.json
응답 (잘림)
{
  "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
      }
    ]
  }
}

GPU 클라우드

GET/api/v1/gpu-clouds.json

GPU 클라우드 공급업체 가격 표 — 선별된 스냅샷과 Vast 라이브 스팟 가격, 카드별로 제공됩니다.

요청
curl https://tkx.org/api/v1/gpu-clouds.json
응답 (잘림)
{
  "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 实时抓取此源。"
    }
  ]
}

이력

GET/api/v1/history/ttpi.json

TTPI 일별 이력 (30일 윈도).

요청
curl https://tkx.org/api/v1/history/ttpi.json
응답 (잘림)
{
  "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

소스 및 카드별 GPU 가격 일별 이력 (30일 윈도).

요청
curl https://tkx.org/api/v1/history/gpu.json
응답 (잘림)
{
  "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": {}
}

메타

GET/api/v1/meta.json

수집 메타데이터 — 개수 및 소스별 상태(보조 dev/apps/gpu 소스 포함).

요청
curl https://tkx.org/api/v1/meta.json
응답 (잘림)
{
  "generatedAt": "2026-07-22T16:07:24.242Z",
  "counts": {
    "models": 1593,
    "offers": 3177,
    "pages": 207
  },
  "sources": [
    {
      "source": "litellm",
      "ok": true,
      "count": 2068
    }
  ]
}

OpenAPI 사양

GET/api/v1/openapi.json

전체 기계 판독 가능한 계약(OpenAPI 3.1). codegen / Swagger UI가 이를 가리키도록 하십시오.

요청
curl https://tkx.org/api/v1/openapi.json
응답 (잘림)
{
  "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"
          }
        }
      }
    }
  }
}
← 이전
출처 표기 및 제한