Farpy Benchmark API

Read-only public endpoints. Data is derived from submitted benchmark receipts.

Model

The public benchmark API is receipt-first. Result, GPU, compare, search, and latest responses are derived from stored benchmark receipt rows.

Version fields such as benchmark_version, scene_version, and scoring_version identify which benchmark and scoring contract produced a result. Percentile calculations use matching benchmark/scoring buckets when available.

Unknown or missing fields are returned as null or "unknown". Empty datasets return empty arrays or counts. There is no fake fallback data.

Endpoints

Endpoint	Description
`GET /node/v1/leaderboard/top`	Top benchmark rows, sorted by score.
`GET /node/v1/leaderboard/stats`	Overall public leaderboard summary.
`GET /node/v1/leaderboard/result/<result_id>`	One receipt-shaped public benchmark result.
`GET /node/v1/leaderboard/gpu/<gpu_slug>`	GPU aggregate summary, latest results, and percentile distribution when enough samples exist.
`GET /node/v1/leaderboard/compare/<gpu_a>/<gpu_b>`	Receipt-derived comparison between two GPU aggregate summaries.
`GET /node/v1/leaderboard/search?q=<query>`	Search result and GPU rows by public receipt fields.
`GET /node/v1/leaderboard/latest?limit=<n>`	Newest receipt-shaped benchmark results. Default limit is 25; maximum is 100.

Example shapes

Values below are examples, not live claims.

Result

{
  "result_id": "bm_example_result",
  "receipt_id": "br_example_receipt",
  "gpu_name": "Example GPU",
  "gpu_slug": "example-gpu",
  "score": 1234,
  "render_seconds": 45.6,
  "benchmark_version": "benchmark_receipt_v1",
  "scoring_version": "score-v1",
  "global_percentile_label": "unknown",
  "public_result_url": "https://farpy.com/benchmark/result/bm_example_result"
}

GPU

{
  "gpu_name": "Example GPU",
  "gpu_slug": "example-gpu",
  "sample_count": 3,
  "average_score": 1200,
  "median_score": 1234,
  "top_score": 1400,
  "average_render_seconds": 45.6,
  "percentile_distribution": {
    "top_1": 0,
    "top_5": 0,
    "top_10": 0,
    "top_25": 0,
    "top_50": 1,
    "bottom_50": 2
  }
}

Search

{
  "query": "example",
  "result_count": 2,
  "results": [
    {
      "type": "result",
      "title": "Example GPU",
      "result_id": "bm_example_result",
      "gpu_slug": "example-gpu",
      "url": "https://farpy.com/benchmark/result/bm_example_result"
    },
    {
      "type": "gpu",
      "title": "Example GPU",
      "gpu_slug": "example-gpu",
      "sample_count": 3,
      "url": "/benchmark/gpu/example-gpu"
    }
  ]
}