---
title: "Get all auctions."
method: GET
path: "/atomicmarket/v1/auctions"
tags: ["auctions"]
---

# Get all auctions.

`GET /atomicmarket/v1/auctions`

You can filter the result by specific asset / template data fields.You can add for example &template_data.rarity=common to only receive results which have an attribute "rarity" with the value "common". You can query specific asset data by using &immutable_data.rarity=common or &mutable_data.rarity=common .If you want to query a non text type you need to specify it explicitly (defaults to text type) like data:bool.foil=true or data:number.id=4 or data:text.rarity=common. Integers which are defined greater than 32 bit (eg 64 bit) in the schema need to be queried as text.

## Query parameters

- `state` string
- `bidder` string
- `participant` string
- `hide_empty_auctions` boolean
- `hide_templates_by_accounts` string
- `max_assets` integer
- `min_assets` integer
- `show_seller_contracts` boolean
- `contract_whitelist` string
- `seller_blacklist` string
- `buyer_blacklist` string
- `asset_id` unknown
- `marketplace` string
- `maker_marketplace` string
- `taker_marketplace` string
- `symbol` string
- `account` string
- `seller` string
- `buyer` string
- `min_price` number
- `max_price` number
- `min_template_mint` number
- `max_template_mint` number
- `collection_name` string
- `schema_name` string
- `template_id` integer
- `burned` boolean
- `owner` string
- `match` string
- `search` string
- `match_immutable_name` string
- `match_mutable_name` string
- `is_transferable` boolean
- `is_burnable` boolean
- `minter` string
- `burner` string
- `initial_receiver` string
- `collection_blacklist` string
- `collection_whitelist` string
- `auction_id` string
- `ids` string
- `lower_bound` string
- `upper_bound` string
- `before` integer
- `after` integer
- `page` integer
- `limit` integer
- `order` 'asc' | 'desc'
- `sort` 'created' | 'updated' | 'ending' | 'auction_id' | 'price' | 'template_mint' | 'name'

## Response `200`

OK

- object
  - `success` boolean
  - `data` Auction[]
    - `market_contract` string
    - `assets_contract` string
    - `auction_id` string
    - `seller` string
    - `buyer` string, nullable
    - `price` object
      - `amount` string
      - `token_precision` integer
      - `token_contract` string
      - `token_symbol` string
    - `assets` Asset[]
      - `contract` string
      - `asset_id` string
      - `owner` string
      - `name` string
      - `is_transferable` boolean
      - `is_burnable` boolean
      - `template_mint` string
      - `collection` object
        - `collection_name` string
        - `name` string
        - `author` string
        - `allow_notify` boolean
        - `authorized_accounts` string[]
        - `notify_accounts` string[]
        - `market_fee` number
        - `created_at_block` string
        - `created_at_time` string
      - `schema` object
        - `schema_name` string
        - `format` object[]
          - `name` string
          - `type` string
        - `created_at_block` string
        - `created_at_time` string
      - `template` object
        - `template_id` string
        - `max_supply` string
        - `issued_supply` string
        - `is_transferable` boolean
        - `is_burnable` boolean
        - `immutable_data` object
        - `created_at_time` string
        - `created_at_block` string
      - `backed_tokens` object[]
        - `token_contract` string
        - `token_symbol` string
        - `token_precision` integer
        - `amount` string
      - `immutable_data` object
      - `mutable_data` object
      - `data` object
      - `burned_by_account` string
      - `burned_at_block` string
      - `burned_at_time` string
      - `updated_at_block` string
      - `updated_at_time` string
      - `transferred_at_block` string
      - `transferred_at_time` string
      - `minted_at_block` string
      - `minted_at_time` string
    - `bids` object[]
      - `number` integer
      - `account` string
      - `amount` string
      - `created_at_block` string
      - `created_at_time` string
      - `txid` string
    - `maker_marketplace` string, nullable
    - `taker_marketplace` string, nullable
    - `collection` object
      - `collection_name` string
      - `name` string
      - `author` string
      - `allow_notify` boolean
      - `authorized_accounts` string[]
      - `notify_accounts` string[]
      - `market_fee` number
      - `created_at_block` string
      - `created_at_time` string
    - `state` integer
    - `end_time` string
    - `updated_at_block` string
    - `updated_at_time` string
    - `created_at_block` string
    - `created_at_time` string
  - `query_time` integer, nullable

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/worldwide-asset-exchange/apis/atomicassets-api.md) · [All operations](https://skmtc.net/worldwide-asset-exchange/apis/atomicassets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worldwide-asset-exchange/atomicassets-api/versions/6e5b195ccabb/schema)