> ## 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

> 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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
cloudx auction bids [flags]
```

### Additional Flags

| Flag             | Required | Description                                                                                    |
| ---------------- | -------- | ---------------------------------------------------------------------------------------------- |
| `--floor-source` | No       | Effective floor source filter. Allowed values: `static`, `dynamic`, `publisher`, `configured`. |

### Examples

```bash theme={null}
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.

```bash theme={null}
cloudx auction list --period last_7d --json
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json
```

## Related

* [CloudX CLI Overview](/en/cli)
* [Reporting Commands](/en/cli/reporting)
* [Examples](/en/cli/examples)