Cubify
Back to AI instructions

Cubify8 / Rank projection

Goal API

Model the rank impact of a hypothetical official result for one event and result type.

POST/api/v1/goals/projectionLive

Why use this API?

Use Goal when a cuber asks what a target time could mean for their national, continental, and world standing.

Request example

What to send

request.httphttp
POST /api/v1/goals/projection
Content-Type: application/json

{
  "wcaId": "2022RPRA01",
  "eventId": "333",
  "rankType": "average",
  "hypotheticalBest": 1500
}

Response example

What comes back

response.jsonjson
{
  "data": {
    "eventId": "333",
    "rankType": "average",
    "previousBest": 1163,
    "hypotheticalBest": 1500,
    "projectedRanks": { "nr": { "rank": 1857 }, "cr": { "rank": 16988 }, "wr": { "rank": 43776 } }
  }
}

Practical use

When it helps

  • Explore what a target average may do to a 3×3 ranking.
  • Turn a training goal into a measurable rank outcome.
  • Let an AI explain rank movement with clearly bounded assumptions.

Data notes

Use it responsibly

  • hypotheticalBest is an integer in official WCA units; 1500 means 15.00 seconds.
  • Projection uses Cubify rank-list data and is not a guarantee of a future rank.
  • Use single or average according to the event’s official result type.