---
title: "Get Auction by Symbol"
method: GET
path: "/v1/markets/{symbol}/auctions"
tags: ["auction-public"]
---

# Get Auction by Symbol

`GET /v1/markets/{symbol}/auctions`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/markets/{symbol}/auctions`
- Auth: none required
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/markets/:symbol/auctions/get.ts> (a function with typed inputs; its response is checked against the schema)

Get current auction information and phase for a symbol.

## Path parameters

- `symbol` string, required: market symbol. E.g. `BTCUSDC`

## Response `200`

OK

- object
  - `data` Auction[]
    - `auctionId` string: unique auction identifier
    - `symbol` string: market symbol. E.g. `BTCUSDC`
    - `phase` 'COOLING' | 'ACCUMULATION' | 'LOCKDOWN' | 'CROSS': current auction phase: COOLING, ACCUMULATION, LOCKDOWN, CROSS
    - `startTime` string, date-time: ISO 8601 with millisecond as string
    - `lockdownTime` string, date-time: ISO 8601 with millisecond as string
    - `scheduledCrossTime` string, date-time: ISO 8601 with millisecond as string
    - `createAuctionOrderEnabled` boolean: whether new auction orders can be created. Defaults true after auction starts (post-cooling)
    - `amendAuctionOrderEnabled` boolean: whether auction orders can be amended. Defaults true after auction starts; auto-switches to false during lockdown
    - `cancelAuctionOrderEnabled` boolean: whether auction orders can be cancelled. Defaults true after auction starts; auto-switches to false during lockdown
    - `createdAt` string, date-time: ISO 8601 with millisecond as string
    - `updatedAt` string, date-time: ISO 8601 with millisecond as string

## Other responses

- `400`: Bad Request
- `404`: Symbol not found or auction not available
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)