Your first request

Make a public request#

Fetch Runecloth (item key 14047) in Normal Alliance. This read is public; leave the Authorization header out.

curl --fail-with-body --show-error "https://auctionhouse.fyi/api/v1/ah/forever.normal.alliance.us/14047"

Read the response#

An illustrative response is below. Prices and observation times vary; a market may have no reading yet.

{
  "market": "forever.normal.alliance.us",
  "item": 14047,
  "row": [125, 50, 1790683200000],
  "days": [],
  "volume": [],
  "now": 1790686800000,
  "live": false
}

row[price, quantity, at] | null

The latest reading available to you. 125 copper = 1 silver 25 copper per item. A null row means no reading; a null price means none listed at the last complete observation.

quantityinteger | null

Overall quantity listed is public: this example has 50 units. A null quantity in an older response means unknown, not zero supply. Per-level depth and volume require additional features.

liveboolean

false means the hourly view. Uploads can be accepted before the next snapshot publishes.

at / nowUnix milliseconds

The row's at is observation time; now is the response's server time. Compare them to judge freshness.

Connect your client#

For authenticated reads, create a key and inspect your features. For ingestion, capture actual auction detail and follow Upload a book. The endpoint directory lists market, item, history and account routes.