What it is
GET /api/v1/osrs/{item} on kbve.com: the latest Grand Exchange high, low and
average for one item. {item} is a numeric id or a name in any shape a link
has used — abyssal-whip, Abyssal_whip, Abyssal whip — matched by the
same slug rule the site builds its /osrs/ pages under.
The OSRS Wiki’s item mapping and latest prices are its only upstream. The
mapping refreshes every six hours and the prices every minute, each swapped in
whole, so a request never waits on the wiki. /health reports 503 until the
first mapping has loaded, which keeps the pod out of the Service until it can
answer.
Where it came from
The first route moved out of axum-kbve, with the response shape unchanged. The
item pages’ redirects (/osrs/{id}, family members) are static data and went
to kbve-web instead.
Releasing
Bump version: above. The kbve-osrs job publishes the image and
kbve-osrs-deploy opens the merge request that repoints
kbve-osrs-deployment.yaml.
Discuss on the forum
Questions, fixes and notes on this page live in the KBVE forum.