Auction Inspection

Reference for cloudx auction commands, including filters, output formats, ILRD inspection, round metrics, and bid floor analysis.

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.

Flag	Required	Default	Description
`--period`	No	`today`	Auction time range. Supports `today`, `yesterday`, `last_7d`, `last_30d`, `YYYY-MM-DD`, or `YYYY-MM-DD..YYYY-MM-DD`.
`--test-mode`	No	`production`	Inventory mode filter. Allowed values: `production`, `test`, `all`.
`--app`	No		App bundle filter, for example `com.example.game`.
`--ad-unit-id`	No		CloudX ad unit ID filter.
`--country`	No		ISO-3166-1 alpha-2 country code filter, for example `US` or `GB`.
`--device-os`	No		Device OS filter. Allowed values: `iOS`, `Android`.
`--limit`	No	`50`	Maximum rows to return. Must be between `0` and `500`.
`--json`	No	`false`	Emit 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

Flag	Required	Description
`--has-ilrd`	No	Only show auctions with CloudX ILRD.
`--has-external-ilrd`	No	Only show auctions with external mediator ILRD.
`--mediator`	No	External 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

Flag	Required	Description
`--with`	No	Comma-separated optional sections. Allowed values: `rounds`, `bids`, `ilrd`, `external-ilrd`.
`--json`	No	Emit 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

Flag	Required	Default	Description
`--auction-id`	No		Auction ID to inspect. When set, filters and metric aggregation are ignored server-side.
`--metric`	No	`distribution`	Aggregate 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

Flag	Required	Description
`--floor-source`	No	Effective 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