StarStock Market API

Base URL: https://api.starstock.app

• All responses are JSON with Content-Type: application/json (except the CSV endpoints).
• CORS is open (Access-Control-Allow-Origin: *) — call it from any website or script.
• Successful responses look like { "ok": true, ... }; errors like { "ok": false, "error": "..." } with an HTTP 4xx/5xx status.
• No API key or sign-up required. It's read-only — there are no write endpoints.

• Rate limit: ~300 requests per minute per IP. Over that returns HTTP 429 with a reset_at timestamp — back off and retry after it.
• Data freshness: prices update every few minutes. Responses are edge-cached ~30–60s, so polling faster than that just returns the same cached data. Please cache on your end and don't poll in a tight loop.
• Bulk data: if you want the whole market, pull /api/v1/catalog.json or /api/v1/items.csv once, not thousands of per-item calls.
• This is a hobby project offered as-is, with no uptime or accuracy guarantee. A credit/link back to StarStock is appreciated but not required.

Most price fields come in two flavors: Jita (the main trade hub) and Everywhere (best price across all hubs). Item-list fields cheapest_sell/cheapest_buy are the Jita view; the CSV endpoints take ?scope=all to switch to Everywhere. sell = lowest price to buy from, buy = highest price to sell into.

List items with their current prices, alphabetically.

curl "https://api.starstock.app/api/v1/items?limit=2"

{ "ok": true, "items": [
  { "type_id": 12345, "name": "...", "path": "Ship/Frigate",
    "cheapest_sell": 1250000, "cheapest_buy": 1100000,
    "activity": "High", "icon_url": "icons/12345.png" }
] }

Full detail for one item: current prices, volume, spread, and time-weighted average prices over a window.

?window= sets the averaging window: 7d, 30d, 90d, or all (default 30d). Averages are weighted by how long each price actually held, not a plain mean.

curl "https://api.starstock.app/api/v1/items/51000000006?window=7d"

{ "ok": true, "item": {
  "name": "Rich Veldspar", "cheapest_sell": 30, "cheapest_buy": 20,
  "average_sell": 26.58, "average_buy": 19.73,
  "average_everywhere_sell": 23.51, "average_everywhere_buy": 20.46 }
}

The order book for one item. Returns sell (cheapest first) and buy (highest first) arrays of { price, qty, ss (solar system id), rg (region id), j (1 if at Jita) }.

Note: the sell side lists up to ~110 orders per hub, so very deep items may be truncated (the cheapest orders are always included). Buy orders are top-of-book only.

Price history points for one item (each written when the price actually moved). ?window= = 7d, 30d, 90d, or all (default 30d).

Search items by name. q (min 2 chars) required; limit max 100 (default 30).

curl "https://api.starstock.app/api/v1/search?q=veldspar"

Most recently updated items. limit max 150.

The full category tree, with an item count per leaf. Use a leaf's path with /api/v1/items?path=.

The whole catalog in one compact response. Keys are shortened to keep it small:

The whole market as CSV — paste straight into Google Sheets with =IMPORTDATA("..."). Add ?scope=all for the Everywhere view.

One item as a single CSV row, for auto-updating spreadsheet formulas.

Service metadata: total item count and when the data was last updated.