Skip to main content

​
Auction Inspection

The cloudx auction commands inspect auction records, rounds, bid and non-bid rows, CloudX ILRD, and opted-in external mediator ILRD. Available commands:
  • cloudx auction list for recent auctions matching filters
  • cloudx auction show for one auction and optional related sections
  • cloudx auction rounds for one auction’s rounds or aggregate round metrics
  • cloudx auction bids for bid and non-bid rows matching filters

​
Shared Flags

These flags are shared by list, rounds, and bids.
FlagRequiredDefaultDescription
--periodNotodayAuction time range. Supports today, yesterday, last_7d, last_30d, YYYY-MM-DD, or YYYY-MM-DD..YYYY-MM-DD.
--test-modeNoproductionInventory mode filter. Allowed values: production, test, all.
--appNoApp bundle filter, for example com.example.game.
--ad-unit-idNoCloudX ad unit ID filter.
--countryNoISO-3166-1 alpha-2 country code filter, for example US or GB.
--device-osNoDevice OS filter. Allowed values: iOS, Android.
--limitNo50Maximum rows to return. Must be between 0 and 500.
--jsonNofalseEmit structured JSON instead of human-readable output.
Period parsing uses UTC boundaries. If you omit --period, the command uses today.

​
cloudx auction list

Lists recent auctions matching the requested filters.

​
Usage

cloudx auction list [flags]

​
Additional Flags

FlagRequiredDescription
--has-ilrdNoOnly show auctions with CloudX ILRD.
--has-external-ilrdNoOnly show auctions with external mediator ILRD.
--mediatorNoExternal mediator filter. Allowed values: applovin, admob, levelplay. Requires --has-external-ilrd.
Validation rules:
  • --has-ilrd and --has-external-ilrd cannot be used together.
  • --mediator requires --has-external-ilrd.

​
Examples

cloudx auction list --period today --test-mode all
cloudx auction list --period last_7d --limit 10
cloudx auction list --period yesterday --has-ilrd
cloudx auction list --period today --has-external-ilrd --mediator applovin
cloudx auction list --app com.example.game --ad-unit-id adunit_interstitial_1 --country GB --device-os Android
cloudx auction list --period 2026-04-30..2026-05-01 --json

​
cloudx auction show

Shows one auction. Use --with to include related rows in the same response.

​
Usage

cloudx auction show <id> [flags]

​
Flags

FlagRequiredDescription
--withNoComma-separated optional sections. Allowed values: rounds, bids, ilrd, external-ilrd.
--jsonNoEmit structured JSON instead of human-readable output.

​
Examples

cloudx auction show auc_123
cloudx auction show auc_123 --with rounds,bids
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json

​
cloudx auction rounds

Inspects rounds for one auction or aggregates round metrics across filtered auctions. When --auction-id is set, the command returns that auction’s rounds. Without --auction-id, it returns aggregate metrics for the requested period and filters.

​
Usage

cloudx auction rounds [flags]

​
Additional Flags

FlagRequiredDefaultDescription
--auction-idNoAuction ID to inspect. When set, filters and metric aggregation are ignored server-side.
--metricNodistributionAggregate metric used when --auction-id is omitted. Allowed values: distribution, duration, cleared-on, skip-reason.

​
Examples

cloudx auction rounds --auction-id auc_123
cloudx auction rounds --auction-id auc_123 --json
cloudx auction rounds --period today --metric distribution --test-mode all
cloudx auction rounds --period today --metric duration --app com.example.game --country US --device-os iOS
cloudx auction rounds --period yesterday --metric skip-reason --limit 20 --json

​
cloudx auction bids

Lists bid and non-bid rows matching the requested filters.

​
Usage

cloudx auction bids [flags]

​
Additional Flags

FlagRequiredDescription
--floor-sourceNoEffective floor source filter. Allowed values: static, dynamic, publisher, configured.

​
Examples

cloudx auction bids --period today --test-mode all
cloudx auction bids --period today --floor-source dynamic
cloudx auction bids --period today --floor-source static
cloudx auction bids --period yesterday --floor-source configured --test-mode all
cloudx auction bids --period today --floor-source publisher --country US --json

​
Output Format

By default, auction commands print human-readable metadata and tables for interactive terminal use. Pass --json to return structured data for scripts and downstream analysis. 
cloudx auction list --period last_7d --json
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json