Observed listings, ready to integrate.

Quickstart

One URL. No setup.

Use the global market and request no more than 100 rows per page. Continue increasing offset until a page contains fewer rows than limit.

const url = new URL("https://market-api.spiritvalers.com/v2/markets/global/listings");
url.search = new URLSearchParams({
  snapshot: "2",
  sort: "price-asc",
  limit: "100",
  offset: "0"
});

const response = await fetch(url);
if (!response.ok) throw new Error(`ValeMarket ${response.status}`);
const snapshot = await response.json();

Endpoints

Read the market.

/v2/markets/global/items/1/Flax?limit=100

/v2/markets/global/items/1/Flax/history

{"status":"ok","protocolVersion":2}

Response

Fields that matter.

Listing responses contain marketId, generatedAt, and a listings array. Item routes also echo itemType and itemId.

Freshness

Share the snapshot.

Cloudflare caches public responses for 15 minutes. The snapshot limits database work and gives every integration a consistent view of recently confirmed observations.

1. Honor Cache-Control and ETag. Do not add cache-busting query values or poll faster than the shared snapshot interval.
2. Use generatedAt for snapshot age. Your local request time does not describe data freshness.
3. Filter expiresAt locally. A listing can expire during the 15-minute cache window.
4. Treat rows as observations, not sales. ValeMarket does not report completed transactions or guarantee that a listing remains available.

Errors

Handle status, then JSON.