POST
/
v2
/
market
/
trends
Analyze bucketed market trend movement
curl --request POST \
  --url https://api-v2.watchcollect.com/v2/market/trends \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "bucket": "<string>",
  "metric": "<string>",
  "points": [
    {
      "bucket_start_ms": 123,
      "listing_count": 123,
      "price_sample_count": 123,
      "avg_price_eur_minor": 123,
      "median_price_eur_minor": 123,
      "metric_value": 123
    }
  ],
  "sample_count": 123,
  "warnings": [
    "<string>"
  ],
  "evidence": {
    "endpoint": "<string>",
    "filters_hash": "<string>",
    "from_ms": 123,
    "to_ms": 123
  },
  "start_metric": 123,
  "end_metric": 123,
  "absolute_change": 123,
  "percent_change": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
view_id
string<uuid>
filters
object

Flexible market filter grammar. Documented fields are typed; additional fields are tolerated for forward-compatible frontend experiments and ignored until implemented.

bucket
enum<string>
default:week
Available options:
day,
week,
month
metric
enum<string>
default:median_price_eur_minor
Available options:
avg_price_eur_minor,
median_price_eur_minor,
listing_count
from_ms
integer<int64>
to_ms
integer<int64>
exclude_outliers
boolean
default:false

Response

Bucketed trend response.

bucket
string
required
metric
string
required
points
object[]
required
sample_count
integer
required
confidence
enum<string>
required
Available options:
none,
low,
moderate,
high
warnings
string[]
required
evidence
object
required
start_metric
number<double> | null
end_metric
number<double> | null
absolute_change
number<double> | null
percent_change
number<double> | null