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.
