GET

Get latest confirmed benchmarks for a player

Notes

Query parameter <block_id> must be the latest block. Use /get-block endpoint
Query parameter <player_id> must be lowercase and start with 0x
Returns all confirmed precommits, benchmarks, proofs, and frauds for the player where the benchmark was started within 120 blocks of the latest block.
Fields benchmark.solution_nonces, benchmark.discarded_solution_nonces, benchmark.non_solution_nonces, proof.merkle_proofs, and fraud.allegation will always be null
- To retrieve that data, use /get-benchmark-data endpoint

get/get-benchmarks

Query parameters

block_idstring required

player_idstring required

Id of player

Response

Success

Example response

{
  "precommits": [
    {
      "details": {
        "fee_paid": "123456789123456789"
      },
      "settings": {
        "challenge_id": "c002",
        "algorithm_id": "c002_a001",
        "track_id": "num_variables=100,clauses_to_variables_percent=426"
      }
    }
  ]
}

Changes

Changed in 12 of the 34 revisions of this API.112330

Jun 22, 2026fad74baea1a514See the full diff
- ▲
  the precommits/items/details/num_nonces response's property type/format changed from integer/uint32 to integer/uint64 for status 200
  response-property-type-changed
- ○
  added the optional property precommits/items/details/compute_type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property precommits/items/details/fuel_budget to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property precommits/items/details/hyperparameters to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property precommits/items/details/num_bundles to the response with the 200 status
  response-optional-property-added
Nov 25, 20252621ceeee7f111See the full diff
- ●
  removed the optional property precommits/items/settings/race_id from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property precommits/items/settings/track_id to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 18, 2025f5c2c49d48ea11See the full diff
- ●
  removed the optional property precommits/items/settings/difficulty from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property precommits/items/settings/race_id to the response with the 200 status
  response-optional-property-added
Oct 7, 2025592b27ecb8201See the full diff
- ○
  added the optional property precommits/items/hyperparameters to the response with the 200 status
  response-optional-property-added
Aug 14, 20251b7773489e831See the full diff
- ○
  added the optional property benchmarks/items/details/num_non_solutions to the response with the 200 status
  response-optional-property-added
Aug 13, 202591a72967eb112See the full diff
- ▲
  the benchmarks/items/details/num_discarded_solutions response's property type/format changed from integer/uint32 to integer/uint64 for status 200
  response-property-type-changed
- ▲
  the benchmarks/items/details/num_solutions response's property type/format changed from integer/uint32 to integer/uint64 for status 200
  response-property-type-changed
Aug 12, 2025b20f29448e0c41See the full diff
- ▲
  the response property benchmarks/items/discarded_solution_nonces became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property benchmarks/items/solution_nonces became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property frauds/items/allegation became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property proofs/items/merkle_proofs became nullable for the status 200
  response-property-became-nullable
- ○
  added the optional property benchmarks/items/non_solution_nonces to the response with the 200 status
  response-optional-property-added
Jun 9, 2025c589c03b93d91See the full diff
- ○
  added the optional property proofs/items/merkle_proofs/items/leaf/cpu_arch to the response with the 200 status
  response-optional-property-added
Jun 5, 202577a999862d172See the full diff
- ○
  added the optional property benchmarks/items/details/num_discarded_solutions to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property benchmarks/items/discarded_solution_nonces to the response with the 200 status
  response-optional-property-added
Nov 27, 2024f857f902a23c235See the full diff
- ▲
  the precommits/items/details/fee_paid response's property type/format changed from integer/uint256 to string/ for status 200
  response-property-type-changed
- ▲
  the proofs/items/merkle_proofs/items/leaf/runtime_signature response's property type/format changed from integer/uint64 to array/ for status 200
  response-property-type-changed
- ●
  removed the optional property benchmarks/items/state/sampled_nonces from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property precommits/items/state/rand_hash from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property proofs/items/state/submission_delay from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property benchmarks/items/details/sampled_nonces to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property precommits/items/details/rand_hash to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property proofs/items/details to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property proofs/items/state/block_active to the response with the 200 status
  response-optional-property-added
- ○
  the precommits/items/details/fee_paid response's property pattern ^[0-9]+$ was added for the status 200
  response-property-pattern-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (12 revisions)