---
title: "Get auction state and indicative"
url: https://docs.truemarkets.co/api/institutional/get-market-auction-cefi
description: "Query for the opening-auction state (and, while in an opening auction, the indicative) by instrument ID. If no query parameters are supplied then the state for ALL available instruments is returned. auction_mode is always present; the auction_indicative object is included only while the instrument is in an opening auction (OPENING or LOCKED) and omitted otherwise."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get auction state and indicative

Query for the opening-auction state (and, while in an opening auction, the indicative) by instrument ID. If no query parameters are supplied then the state for ALL available instruments is returned. `auction_mode` is always present; the `auction_indicative` object is included only while the instrument is in an opening auction (OPENING or LOCKED) and omitted otherwise.

## Request

```
GET https://api.truex.co/v1/cefi/market/auction
```

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `instrument_id` | query | string | no | Instrument ID of the market to query for. Must be a valid non-zero numeric ID. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Successful operation.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `[].auction_mode` | boolean | yes | True while the instrument is in an opening auction (ST_OPENING or ST_LOCKED). The auction_indicative object is present only when this is true. |
| `[].auction_indicative` | object | no | Opening-auction state and indicative for an instrument. All fields are zero and status is INVALID when the instrument is not in an opening auction. |
| `[].auction_indicative.indicative_price` | string | no | Indicative opening price the auction would currently clear at. |
| `[].auction_indicative.matched_volume` | string | no | Volume that would cross at the indicative price. |
| `[].auction_indicative.projected_best_bid_price` | string | no | Projected best bid price after a hypothetical uncross; zero when no bids would remain. |
| `[].auction_indicative.projected_best_ask_price` | string | no | Projected best ask price after a hypothetical uncross; zero when no asks would remain. |
| `[].auction_indicative.timestamp` | string | no | A UTC Unix epoch in nanoseconds indicating when the indicative was computed. |
| `[].auction_indicative.status` | string, one of `INVALID`, `NORMAL`, `INSUFFICIENT_BUY_INTEREST`, `INSUFFICIENT_SELL_INTEREST`, `NO_CROSS` | no | Health of the auction indicative calculation. |

### 400

Bad request.

### 500

Internal server error.

### 503

Service unavailable.
