> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Get market price statistics

> Costs 5 credits per request. Returns p25 / median / p75 and a count per day, newest first, over the observations Nephia holds for a market. Defaults to the last 30 days; a range may not exceed 365 days. Days are also split by currency, so percentiles are never averaged across two of them. `soldRate` is always `null` — sold detection is not yet available. Coverage grows with usage: a series exists only for items that appeared in a search Nephia observed — a Vinted Watch tick or a `/v1/vinted/search` request. This is not a complete index of Vinted. Observations are anonymous public listing prices and carry no account identifier. Rows are kept for 365 days.



## OpenAPI

````yaml /openapi.json get /v1/vinted/market/stats
openapi: 3.1.0
info:
  title: Nephia API
  description: >-
    The brand-monitoring API. Create a **Query** and it polls the live Sources
    (X, Reddit, Youtube, TikTok, Bluesky, Hacker News, Mastodon, Lemmy, GitHub,
    Product Hunt, Stack Overflow, RSS, AI answers — and Vinted) on an interval,
    keeps what matches, reads each mention for sentiment and intent, sorts it
    into your buckets and answers your own agent step over it. Read the result
    back as **mentions** — `GET /v1/mentions` across the whole Account, or per
    Query — or have it pushed to you as signed webhook events and delivery
    channels. A search can carry several terms at once, OR'd into one upstream
    request at one tick's cost. Authenticate with an API key on your Account.
    Monitoring is sold as a subscription — queries, terms, freshness and AI —
    with credits as the meter underneath; credit packs are overflow and never
    change a limit. Reading your own mentions is free; the semantic search mode
    and the AI passes are what meter. Request quota is per Account (all API keys
    share one bucket), by Plan: Free 60/min, Solo 350/min, Growth 700/min, Pro
    1200/min.
  version: 1.0.0
servers:
  - url: https://api.nephia.cc
    description: Production
  - url: http://localhost:3000
    description: Local
security:
  - ApiKeyAuth: []
tags:
  - name: Account
    description: Account balance
  - name: Mentions
    description: Everything your Queries caught, across every Source
  - name: Queries
    description: The saved searches that do the catching — read, create, edit, pause
  - name: AI
    description: Group, classify, agent and summarise passes over items you name
  - name: X — Watches
    description: X watches, events, and activity
  - name: Reddit — Watches
    description: Reddit watches, events, and activity
  - name: Youtube — Watches
    description: Youtube watches, events, and activity
  - name: TikTok — Watches
    description: TikTok watches, events, and activity
  - name: Bluesky — Watches
    description: Bluesky watches, events, and activity
  - name: Hacker News — Watches
    description: Hacker News watches, events, and activity
  - name: Mastodon — Watches
    description: Mastodon watches, events, and activity
  - name: Lemmy — Watches
    description: Lemmy watches, events, and activity
  - name: GitHub — Watches
    description: GitHub watches, events, and activity
  - name: Product Hunt — Watches
    description: Product Hunt watches, events, and activity
  - name: Stack Overflow — Watches
    description: Stack Overflow watches, events, and activity
  - name: RSS — Watches
    description: RSS watches, events, and activity
  - name: AI answers — Watches
    description: AI answers watches, runs, events, and activity
  - name: Vinted — Watches
    description: Vinted watches, events, and activity
  - name: Vinted — Analytics
    description: Observed price history and per-day market statistics
paths:
  /v1/vinted/market/stats:
    get:
      tags:
        - Vinted — Analytics
      summary: Get market price statistics
      description: >-
        Costs 5 credits per request. Returns p25 / median / p75 and a count per
        day, newest first, over the observations Nephia holds for a market.
        Defaults to the last 30 days; a range may not exceed 365 days. Days are
        also split by currency, so percentiles are never averaged across two of
        them. `soldRate` is always `null` — sold detection is not yet available.
        Coverage grows with usage: a series exists only for items that appeared
        in a search Nephia observed — a Vinted Watch tick or a
        `/v1/vinted/search` request. This is not a complete index of Vinted.
        Observations are anonymous public listing prices and carry no account
        identifier. Rows are kept for 365 days.
      operationId: getV1VintedMarketStats
      parameters:
        - in: query
          name: market
          schema:
            type: string
            default: fr
        - in: query
          name: from
          schema:
            type: string
        - in: query
          name: to
          schema:
            type: string
        - in: query
          name: brand_id
          schema:
            type: integer
        - in: query
          name: catalog_id
          schema:
            type: integer
        - in: query
          name: size_id
          schema:
            type: integer
        - in: query
          name: status
          schema:
            type: string
        - in: query
          name: currency
          schema:
            type: string
      responses:
        '200':
          description: Per-day market statistics
          content:
            application/json:
              schema:
                type: object
                properties:
                  market:
                    type: string
                  from:
                    type: string
                  to:
                    type: string
                  filters:
                    type: object
                    properties:
                      brand_id:
                        type:
                          - number
                          - 'null'
                      catalog_id:
                        type:
                          - number
                          - 'null'
                      size_id:
                        type:
                          - number
                          - 'null'
                      status:
                        type:
                          - string
                          - 'null'
                      currency:
                        type:
                          - string
                          - 'null'
                    required:
                      - brand_id
                      - catalog_id
                      - size_id
                      - status
                      - currency
                  stats:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                        currency:
                          type: string
                        count:
                          type: number
                        p25:
                          type: number
                        median:
                          type: number
                        p75:
                          type: number
                        soldRate:
                          type:
                            - number
                            - 'null'
                      required:
                        - date
                        - currency
                        - count
                        - p25
                        - median
                        - p75
                        - soldRate
                required:
                  - market
                  - from
                  - to
                  - filters
                  - stats
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '429':
          description: >-
            Request quota exceeded. Retry after the `Retry-After` header
            (seconds). Response includes `RateLimit-*` headers (IETF draft-7).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
              example:
                error: Rate limit exceeded
                code: TOO_MANY_REQUESTS
        '501':
          description: Analytics not configured
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created from the Nephia dashboard for your Account.

````