Grand Exchange logo

Public API

The JSON API behind this site is free to use for bots, spreadsheets, research and tools. No key or signup required for read-only market data.

Ground rules

  • Attribution required. If you publish anything built on this data (a site, bot, spreadsheet, video or article), credit it with a visible link to grandexchange.com.
  • Send a descriptive User-Agent that identifies your project and includes a contact, e.g. my-flip-bot/1.0 ([email protected]). Anonymous default agents may be rate limited.
  • Cache responses. Prices change at most every few minutes and every endpoint sends Cache-Control headers; honour them rather than polling in tight loops.
  • Browser CORS is restricted to our own origin, so call the API from your server, script or bot rather than from another website's front-end JavaScript.

Endpoints

Base URL: https://api.grandexchange.com

GET/api/items?game=osrs&q=whip

Search and browse items with latest prices. Params: game (osrs|rs3), q, page, pageSize, sort.

curl -H "User-Agent: my-tool ([email protected])" "https://api.grandexchange.com/api/items?game=osrs&q=whip"

GET/api/items/:game/:id

One item with its latest buy/sell price, volume, buy limit and metadata.

curl -H "User-Agent: my-tool ([email protected])" "https://api.grandexchange.com/api/items/osrs/4151"

GET/api/items/:game/:id/timeseries?range=30d

Price and volume history for charts. Ranges from 1d up to all history (2021+ for OSRS).

curl -H "User-Agent: my-tool ([email protected])" "https://api.grandexchange.com/api/items/osrs/4151/timeseries?range=30d"

GET/api/prices/osrs?ids=4151,11832

Batch latest prices for up to 50 OSRS item ids in one call.

curl -H "User-Agent: my-tool ([email protected])" "https://api.grandexchange.com/api/prices/osrs?ids=4151,11832"

GET/api/movers?game=osrs&window=24h&type=gainers

Top movers. type: gainers, losers, volume, spike or valuable; window: 1h, 24h or 7d.

curl -H "User-Agent: my-tool ([email protected])" "https://api.grandexchange.com/api/movers?game=osrs&window=24h&type=gainers"

GET/api/guides?game=osrs

Money-making guides with profit/hr computed from live prices.

curl -H "User-Agent: my-tool ([email protected])" "https://api.grandexchange.com/api/guides?game=osrs"

Notes

  • OSRS prices update continuously from real-time trade data; RS3 uses the official daily price.
  • OSRS history goes back to 2021 at up to 5-minute resolution; older windows aggregate hourly/daily.
  • Endpoints and shapes documented here are stable. Anything not listed may change without notice, so build against these six.
  • Building something on it? We would love to see it: say hello via the contact page or our Discord, and we may feature your project.