Skip to content

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.