quotes

The live book for one instrument

get/v2/quotes/{ref}

Request

  • Base URL: https://api.cardog.app
  • URL: https://api.cardog.app/v2/quotes/{ref}
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

refstring required

An instrument ref. Slashes in refs must be URL-encoded (%2F).

Response

NBBO-style quote line: best, percentiles, DOM, cuts

refstring required

Ref of the instrument (the thing being priced: a model year or a squish), e.g. "model-year:honda/cr-v/2026"

grain'mmy' | 'mmy.drive' | 'mmy.fuel' | 'mmy.body' | 'squish' required

Level of detail the instrument is priced at: "mmy" (model year), "mmy.drive", "mmy.fuel" or "mmy.body" (model year split by drive type, fuel type, or body style), or "squish" (exact configuration: WMI + VDS + model year, plant-agnostic)

liveCountinteger required

Number of live listings the quote is computed from. Treat it as the sample size.

bestPricenumber nullable required

Lowest live asking price

priceP25number nullable required

25th percentile of live asking prices

priceMediannumber nullable required

Median live asking price

priceP75number nullable required

75th percentile of live asking prices

avgDomDaysnumber nullable required

Average days on market across the live listings

cuts30dinteger nullable required

Number of price cuts observed in the trailing 30 days

avgCutPct30dnumber nullable required

Average price cut as a percentage, trailing 30 days

sightings30dinteger nullable required

Number of listing observations in the trailing 30 days

asOfstring required

When the quote was last computed (ISO 8601)

linksobject

Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

Changes

No recorded changes to this operation across all 1 revision of this API.