v1

latestOpenAPI 3.1.0MITraw.githubusercontent.com2025-07-16390274.5 KB
Auctions

List auctions with pagination and filtering

Retrieve a paginated list of auctions with advanced filtering options. Requires authentication with read permissions.

get/api/v1/auctions

Query parameters

limitinteger

Number of items per page

Number of items per page

cursorstring

Cursor for pagination

Cursor for pagination

state'scheduled' | 'active' | 'settling' | 'settled'

Filter by auction state

Filter by auction state

created_bystring

Filter by creator user ID

Filter by creator user ID

include_metadataboolean nullable

Include auction metadata

Include auction metadata

include_revenueboolean nullable

Include revenue information

Include revenue information

from_datenumber nullable

Start date as Unix timestamp

Start date as Unix timestamp

to_datenumber nullable

End date as Unix timestamp

End date as Unix timestamp

slot_frominteger nullable

Starting slot number

Starting slot number

slot_tointeger nullable

Ending slot number

Ending slot number

sort_by'createdAt' | 'slot' | 'state' | 'endTime' | 'settledAt' | 'totalBids'
sort_order'asc' | 'desc'

Sort order

Sort order

Response

Successful operation with enhanced pagination

successtrue required
timestampnumber required
cursorstring
hasMoreboolean required
totalnumber
countnumber required