v1

latestOpenAPI 3.0.0raw.githubusercontent.com2025-08-296916379.5 KB

auctions

Get all 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.

get/atomicmarket/v1/auctions

Query parameters

statestring

Filter by auction state (0: WAITING: Auction created but assets were not transferred yet, 1: LISTED - Auction pending and open to bids, 2: CANCELED - Auction was canceled, 3: SOLD - Auction has been sold, 4: INVALID - Auction ended but no bid was made) - separate multiple with ","

bidderstring

Filter by auctions with this bidder

participantstring

Filter by auctions where this account participated and can still claim / bid

hide_empty_auctionsboolean

Hide auctions with no bids

hide_templates_by_accountsstring

Hide templates that are owned by specific accounts

max_assetsinteger

Max assets per listing

min_assetsinteger

Min assets per listing

show_seller_contractsboolean

If false no seller contracts are shown except if they are in the contract whitelist

contract_whiteliststring

Show these accounts even if they are contracts

seller_blackliststring

Dont show listings from these sellers (Split multiple with ",")

buyer_blackliststring

Dont show listings from these buyers (Split multiple with ",")

{"stackTrail":"paths:/atomicmarket/v1/auctions:get:parameters:11:schema","oasType":"schema","type":"unknown"}

Asset id in the offer

marketplacestring

Filter by all sales where a certain marketplace is either taker or maker marketplace - separate multiple with ","

maker_marketplacestring

Maker marketplace - separate multiple with ","

taker_marketplacestring

Taker marketplace - separate multiple with ","

symbolstring

Filter by symbol

accountstring

Filter accounts that are either seller or buyer

sellerstring

Filter by seller - separate multiple with ","

buyerstring

Filter by buyer - separate multiple with ","

min_pricenumber

Lower price limit

max_pricenumber

Upper price limit

min_template_mintnumber

Min template mint

max_template_mintnumber

Max template mint

collection_namestring

Filter by collection name

schema_namestring

Filter by schema name

template_idinteger

Filter by template id

burnedboolean

Filter for burned assets

ownerstring

Filter by owner

matchstring

Search for input in asset name on template data

searchstring

Fuzzy search for input in asset name on template data

match_immutable_namestring

Search for input in asset name on asset immutable data

match_mutable_namestring

Search for input in asset name on asset mutable data

is_transferableboolean

Check if asset is transferable

is_burnableboolean

Check if asset is burnable

minterstring

Filter by account that minted the asset

burnerstring

Filter by account that burned the asset

initial_receiverstring

Filter by account that the asset was minted to

collection_blackliststring

Hide collections from result. Split multiple with ","

collection_whiteliststring

Show only results from specific collections. Split multiple with ","

auction_idstring

seperate multiple ids with ","

idsstring

seperate multiple ids with ","

lower_boundstring

lower bound of primary key (value included)

upper_boundstring

upper bound of primary key (value excluded)

beforeinteger

Only show results before this timestamp in milliseconds (value excluded)

afterinteger

Only show results after this timestamp in milliseconds (value excluded)

pageinteger

Result Page

limitinteger

Results per Page

order'asc' | 'desc'

Order direction

Column to sort

Response

successboolean

query_timeinteger nullable