For agents

Rules

• You only ever see the links on the page you are standing on. There is no page-lookup endpoint, so you cannot precompute a path.
• A move must be a title from the current page's links array. Anything else is a 400.
• Only article-body links are moves. Navboxes, sidebars, reference lists, categories, hatnotes and sister-project links are stripped before the page is served, to you and to a human alike.
• Redirects resolve to the article they point at and count as one move. Landing on a redirect to the target wins.
• Disambiguation pages, List of… / Index of… / Outline of… / Timeline of… articles and bare year or date pages are banned as a start or target ONLY. They remain legal moves mid-race, and you will meet them: a bad prompt ruins a whole race, while a bad link is one of hundreds. Do not treat a 'List of…' title in page.links as a bug.
• Titles are compared after normalization: underscores are spaces and the first letter is capitalized, so "cheese_making" and "Cheese making" are the same move.
• Time and clicks are both recorded. The clock starts when the race is created.
• The token is the entire game state. It is signed; keep it and send back the newest one you were given.
• One race at a time, no accounts, nothing stored server-side. Losing the token loses the race.
• Send a User-Agent header naming your agent. Cloudflare refuses some default library agents (bare Python-urllib, or none at all) with a 403 whose body is the plain text "error code: 1010" rather than JSON. curl, python-requests, node fetch and any custom string are fine.

Endpoints

POST /api/race

Send an empty object for a random pair, or name the pair yourself. Bare years and dates, disambiguation pages and List of… articles are rejected here with banned-prompt — as prompts only. They are still ordinary links, so expect to see them in page.links and to pass through them mid-race. The prompt filter is stricter than the move filter on purpose: a bad prompt ruins a whole race, while a bad link is one of hundreds.

curl -s -X POST https://wikiracer.dunkeybuilds.com/api/race \
  -H 'content-type: application/json' -d '{}'

{
  "token": "eyJzdGFydCI6IkNoZWVzZSIs….BIXMjCEQem92ndMTo3",
  "status": "racing",
  "start": "Cheese",
  "target": "Buzz Aldrin",
  "moves": 0,
  "elapsedMs": 2,
  "path": ["Cheese"],
  "page": {
    "title": "Cheese",
    "extract": "Cheese is a type of dairy product produced in a range of flavors, textures, and forms by coagulation of the milk protein…",
    "links": ["Acid", "Bacteria", "Casein", "Dairy", "Milk", "…"]
  }
}

page.links is the whole board. Cheese offers 250 of them; that is a typical article.

POST /api/race/move

to must be one of the titles in page.links from the response you are holding. The reply is the same shape, with a fresh token — use that one next.

curl -s -X POST https://wikiracer.dunkeybuilds.com/api/race/move \
  -H 'content-type: application/json' \
  -d '{"token":"eyJzdGFydCI6IkNoZWVzZSIs…","to":"Milk"}'

When you land on the target, status flips to "won", elapsedMs freezes, and path holds the whole route. Moving again in a finished race is a 409, not a 400.

GET /api/race?token=…

Reads the race back without spending a move: the same RaceView, current page and links included. This is how to recover after a crash, or to confirm where you are standing before betting on a move.

curl -s "https://wikiracer.dunkeybuilds.com/api/race?token=eyJzdGFydCI6IkNoZWVzZSIs…"

GET /api/race/article?token=…

Returns text/html for the page you are standing on, already stripped down to article prose. Every legal link in it is <a href="#" class="wr-link" data-title="Some Title"> and everything else has been unwrapped to plain text — so the anchors in this HTML are exactly page.links. An agent can skip this route entirely; it exists because the browser game is a client of this same API.

curl -s "https://wikiracer.dunkeybuilds.com/api/race/article?token=eyJzdGFydCI6IkNoZWVzZSIs…"

Errors

Every failure is { "error": { "code", "message" } }. The message is written to be read by whatever is driving you.

{
  "error": {
    "code": "illegal-move",
    "message": "\"Barack Obama\" is not a link on \"Cheese\". You may only move to a title listed in this page's links."
  }
}

A whole race, in shell

Needs curl and jq. This one is winnable in a single move, so it runs top to bottom as written. Every step keeps the newest token; nothing else is state.

# 1. Start. The token is the entire game state.
BASE=https://wikiracer.dunkeybuilds.com
curl -s -X POST $BASE/api/race -H 'content-type: application/json' -d '{"start":"Cheese","target":"Milk"}' > race.json
TOKEN=$(jq -r .token race.json)
jq '{start, target, links: (.page.links | length)}' race.json
# { "start": "Cheese", "target": "Milk", "links": 250 }

# 2. Look around. These titles are the only legal moves from here.
jq -r '.page.links[]' race.json | head -30

# 3. Move. Same response shape, new token.
BODY='{"token":"'$TOKEN'","to":"Milk"}'
curl -s -X POST $BASE/api/race/move -H 'content-type: application/json' -d "$BODY" > race.json
TOKEN=$(jq -r .token race.json)

# 4. Repeat 2 and 3 until status is won.
jq '{status, moves, elapsedMs, path}' race.json
# { "status": "won", "moves": 1, "elapsedMs": 83, "path": ["Cheese", "Milk"] }

# Optional: read the race back without moving.
curl -s "$BASE/api/race?token=$TOKEN" | jq '{status, moves, path}'

Agent loop

The only interesting line is choose: you have the target, the titles visible from here, and where you have already been. Nothing else.

// JavaScript
const BASE = "https://wikiracer.dunkeybuilds.com";

async function post(path, body) {
  const res = await fetch(BASE + path, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify(body),
  });
  const data = await res.json();
  if (!res.ok) throw new Error(data.error.code + ": " + data.error.message);
  return data;
}

let race = await post("/api/race", {});
while (race.status !== "won") {
  // race.page.links is everything you can see from where you stand.
  const next = choose(race.target, race.page.links, race.path);
  race = await post("/api/race/move", { token: race.token, to: next });
}
console.log(race.moves, "clicks in", race.elapsedMs, "ms", race.path);

# Python
import requests

BASE = "https://wikiracer.dunkeybuilds.com"
s = requests.Session()
# Send a User-Agent that names your agent. A default library one can be
# refused at the edge before it reaches this API — see Etiquette below.
s.headers["user-agent"] = "my-wikirace-agent/1.0"

race = s.post(BASE + "/api/race", json={}).json()
while race["status"] != "won":
    # race["page"]["links"] is your entire view of the graph.
    nxt = choose(race["target"], race["page"]["links"], race["path"])
    r = s.post(BASE + "/api/race/move", json={"token": race["token"], "to": nxt})
    r.raise_for_status()  # 400 illegal-move: that title was not on the page
    race = r.json()

print(race["moves"], "clicks in", race["elapsedMs"], "ms", race["path"])