---
search:
  tags:
    - Markets
    - GET
seo:
  description: >-
    Returns a market's open interest, last price, and day and lifetime trading
    activity. Reference for the GET /markets/{ticker}/stats endpoint in the REST
    API.
sidebar:
  label: Get a Market's Stats
  badge: GET
title: Get a Market's Stats
type: openapi-operation
---
Returns a market's open interest, last price, and day and lifetime trading activity.

### Endpoint

- Method and path: `GET /markets/{ticker}/stats`
- Operation ID: `getMarketStats`
- API reference: [GET /markets/{ticker}/stats](/api-reference/rest/markets/get-market-stats)
- Complete specification: [OpenAPI (YAML)](/openapi.yml)
- Spec location (JSON Pointer): `#/paths/~1markets~1{ticker}~1stats/get`

#### Authorization

- Credential: optional. An authenticated request is metered against the member's read bucket and returns RateLimit headers; an unauthenticated request shares the public per-client limit.
- Accepted credentials: `UDX-Access-Key` header and `UDX-Access-Timestamp` header and `UDX-Access-Signature` header; or Bearer token in `Authorization`
- Details: [Authentication](/reference/authentication)

#### Parameters

```yaml
- $ref: "#/components/parameters/VersionHeader"
- name: ticker
  in: path
  required: true
  description: The market's ticker.
  schema:
    $ref: "#/components/schemas/Ticker"
```


#### Responses

##### `200`

The market's trading activity summary.

Headers:

```yaml
UDX-Version:
  $ref: "#/components/headers/VersionHeader"
Cache-Control:
  $ref: "#/components/headers/NoStore"
```

Content type: `application/json`

Schema:

```yaml
$ref: "#/components/schemas/MarketStatsResponse"
```

Example: Example

```json
{
  "stats": {
    "ticker": "UDX-EXAMPLE-MARKET",
    "open_interest": "1200",
    "last_price": "0.54",
    "day": {
      "open": "0.51",
      "high": "0.56",
      "low": "0.5",
      "volume": "840",
      "notional": "445.2"
    },
    "lifetime": {
      "high": "0.61",
      "low": "0.38",
      "volume": "19400",
      "notional": "9870",
      "trade_count": 612
    },
    "updated_at": "2026-01-01T00:00:00.000000Z"
  }
}
```

##### `404`

No market with this ticker exists.

Headers:

```yaml
UDX-Version:
  $ref: "#/components/headers/VersionHeader"
```

Content type: `application/problem+json`

Schema:

```yaml
$ref: "#/components/schemas/ProblemDetails"
```

Example: Example

```json
{
  "type": "urn:udx:problem:market-not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "market not found",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```

##### `429`

The request rate was exceeded. An unauthenticated request shares the public per-client limit; an authenticated request is metered against the member's read bucket.

Headers:

```yaml
UDX-Version:
  $ref: "#/components/headers/VersionHeader"
Retry-After:
  $ref: "#/components/headers/RetryAfter"
Cache-Control:
  $ref: "#/components/headers/NoStore"
```

Content type: `application/problem+json`

Schema:

```yaml
$ref: "#/components/schemas/ProblemDetails"
```

Example: Public limit exceeded

```json
{
  "type": "urn:udx:problem:unauthenticated-rate-limit-exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "this client has temporarily exceeded the public request rate",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```

Example: Member limit exceeded

```json
{
  "type": "urn:udx:problem:member-rate-limit-exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "this member has temporarily exceeded its request rate",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```

##### `500`

Something went wrong on UDX's side.

Headers:

```yaml
UDX-Version:
  $ref: "#/components/headers/VersionHeader"
```

Content type: `application/problem+json`

Schema:

```yaml
$ref: "#/components/schemas/ProblemDetails"
```

Example: Internal server error

```json
{
  "type": "urn:udx:problem:internal-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "internal error",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```

##### `503`

Request admission or account setup is unavailable, or the read could not be completed in time; retry.

Headers:

```yaml
UDX-Version:
  $ref: "#/components/headers/VersionHeader"
Retry-After:
  $ref: "#/components/headers/RetryAfter"
Cache-Control:
  $ref: "#/components/headers/NoStore"
```

Content type: `application/problem+json`

Schema:

```yaml
$ref: "#/components/schemas/ProblemDetails"
```

Example: Caller setup is not ready

```json
{
  "type": "urn:udx:problem:projection-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "account setup is still being completed; retry later",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```

Example: Request admission is unavailable

```json
{
  "type": "urn:udx:problem:request-admission-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "request admission is temporarily unavailable",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```

Example: The read could not be completed in time

```json
{
  "type": "urn:udx:problem:could-not-process-retry",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "could not process request, please retry",
  "instance": "urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef"
}
```


#### Referenced definitions

The references in the excerpts above resolve to these definitions in the complete specification.

##### `#/components/headers/VersionHeader`

```yaml
description: API version used for this response.
schema:
  type: string
  maxLength: 10
  description: A dated API version (YYYY-MM-DD).
  example: 2026-07-15
```

##### `#/components/headers/NoStore`

```yaml
description: Prevents caching this response.
schema:
  type: string
  enum:
    - no-store
  description: Always the cache directive no-store.
  example: no-store
```

##### `#/components/schemas/MarketStatsResponse`

```yaml
type: object
description: One market's trading activity summary.
required:
  - stats
properties:
  stats:
    $ref: "#/components/schemas/MarketStats"
```

##### `#/components/schemas/MarketStats`

```yaml
type: object
description: A market's trading activity summary.
allOf:
  - $ref: "#/components/schemas/MarketStatsUpdate"
  - type: object
    required:
      - lifetime
    properties:
      lifetime:
        $ref: "#/components/schemas/MarketLifetimeStats"
```

##### `#/components/schemas/MarketStatsUpdate`

```yaml
type: object
additionalProperties: false
description: The exchange's live figures for a market.
required:
  - ticker
  - open_interest
  - day
  - updated_at
properties:
  ticker:
    $ref: "#/components/schemas/Ticker"
  open_interest:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,2})?$
    maxLength: 24
    description: Contracts held long, which equals contracts held short.
    example: "100"
  last_price:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Price of the most recent trade on any day. Absent until the market has traded.
    example: "0.55"
  day:
    $ref: "#/components/schemas/MarketDayStats"
  updated_at:
    type: string
    format: date-time
    maxLength: 40
    description: When the exchange last updated these figures.
    example: 2026-01-01T00:00:00.000000Z
```

##### `#/components/schemas/Ticker`

```yaml
type: string
minLength: 1
maxLength: 128
description: A human-meaningful natural key naming a single-leg or multi-leg market.
example: UDX-EXAMPLE-MARKET
```

##### `#/components/schemas/MarketDayStats`

```yaml
type: object
additionalProperties: false
description: Trading activity in the current trade day. Prices are absent until the market trades in the day.
required:
  - volume
  - notional
properties:
  open:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Price of the day's first trade.
    example: "0.55"
  high:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Highest trade price of the day.
    example: "0.55"
  low:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Lowest trade price of the day.
    example: "0.55"
  volume:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,2})?$
    maxLength: 24
    description: Contracts traded in the day.
    example: "100"
  notional:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Dollars traded in the day.
    example: "0.55"
```

##### `#/components/schemas/MarketLifetimeStats`

```yaml
type: object
additionalProperties: false
description: Trading activity since the market was listed. Prices are absent until the market has traded.
required:
  - volume
  - notional
  - trade_count
properties:
  high:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Highest trade price since listing.
    example: "0.55"
  low:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Lowest trade price since listing.
    example: "0.55"
  volume:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,2})?$
    maxLength: 24
    description: Contracts traded since listing.
    example: "100"
  notional:
    type: string
    pattern: ^[0-9]+(\.[0-9]{1,6})?$
    maxLength: 24
    description: Dollars traded since listing.
    example: "0.55"
  trade_count:
    type: integer
    format: int64
    minimum: 0
    description: Trades since listing.
```

##### `#/components/schemas/ProblemDetails`

```yaml
type: object
description: An RFC 9457 machine-readable error, returned on every non-2xx response. The response's Content-Language header identifies the language used by title and detail, and Vary includes Accept-Language.
required:
  - type
  - title
  - status
properties:
  type:
    type: string
    format: uri-reference
    maxLength: 2048
    description: A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.
  title:
    type: string
    maxLength: 40
    example: Bad Request
    description: A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.
  status:
    type: integer
    example: 400
    description: The HTTP status code, repeated from the response itself.
  detail:
    type: string
    maxLength: 500
    example: malformed request body
    description: A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.
  instance:
    type: string
    format: uri-reference
    maxLength: 100
    example: urn:request-id:8f14e45f-ceea-4abc-a743-e89a34d3f6ef
    description: An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.
```

##### `#/components/headers/RetryAfter`

```yaml
description: Whole seconds to wait before retrying.
schema:
  type: integer
  minimum: 1
  description: A positive delay in whole seconds.
  example: 2
```

##### `#/components/parameters/VersionHeader`

```yaml
name: UDX-Version
in: header
required: false
description: Dated API version (YYYY-MM-DD).
schema:
  type: string
  minLength: 10
  maxLength: 10
  description: A dated API version (YYYY-MM-DD).
  example: 2026-07-15
```