Model Catalog & Leaderboard — ML Junction docs

GET /v1/models is public and cache-friendly. It powers model discovery and the seven-day popularity leaderboard.

curl "$ASTRO_BASE_URL/v1/models"

{
  "id": "gpt-5.5",
  "object": "model",
  "owned_by": "mljunction",
  "description": "Default openai route",
  "access": "public_catalog",
  "lifecycle": {
    "status": "active",
    "going_away_at": null,
    "replacement_model": null
  },
  "providers": ["openai"],
  "stats": {
    "rank": 3,
    "requests_7d": 1820000,
    "tokens_7d": 940000000,
    "trend_pct_7d": 12.4
  }
}

Field · Definition
stats.rank · Descending requests_7d, then tokens_7d, then model ID
stats.requests_7d · Requests started in the trailing seven days
stats.tokens_7d · Persisted total tokens in the trailing seven days
stats.trend_pct_7d · Request-count change versus the preceding seven days
lifecycle.status · active, preview, deprecated, or retired
lifecycle.going_away_at · Retirement/deprecation timestamp when known
lifecycle.replacement_model · Suggested replacement public model

The stats object is omitted when there is no current or prior seven-day activity. trend_pct_7d is omitted when the previous period is zero. Never treat either omission as a numeric zero.

Canonical URL: https://mljunction.com/docs/model-catalog