Documentation Index
Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
Use this file to discover all available pages before exploring further.
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 filterscloudx auction show for one auction and optional related sectionscloudx auction rounds for one auction’s rounds or aggregate round metricscloudx 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, 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. |
--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
--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
