> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-398.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai metrics gpu-trends

\[Host] Get GPU market history

## Usage

```bash theme={null}
vastai metrics gpu-trends [NAME] [OPTIONS]
```

## Arguments

<ParamField path="name" type="string" required default="RTX 5090,RTX 4090,RTX 3090">
  GPU name, comma-separated list, or 'all'. Underscores are accepted in place of spaces.
</ParamField>

## Options

<ParamField path="--verified" type="string" default="all">
  Filter by verified status
  Allowed values: true, false, all
</ParamField>

<ParamField path="--datacenter" type="string" default="all">
  Filter by datacenter hosting type
  Allowed values: true, false, all
</ParamField>

<ParamField path="--num-gpus" type="string" default="all">
  Filter by machine GPU-count bucket (1x, 2x, 4x, 8x)
  Allowed values: all, 1, 2, 4, 8
</ParamField>

<ParamField path="--start" type="integer">
  Start unix timestamp
</ParamField>

<ParamField path="--end" type="integer">
  End unix timestamp
</ParamField>

<ParamField path="--step" type="integer">
  Time between data points in seconds (e.g. 3600 for hourly). Minimum 60s; step may be raised server-side to cap points returned.
</ParamField>

## Description

Show GPU supply/demand and pricing trends over time. Defaults to RTX 5090, 4090, 3090
for the last 24 hours. Requires host or admin access.

## Examples

```bash theme={null}
vastai metrics gpu-trends
    vastai metrics gpu-trends "RTX 4090"
    vastai metrics gpu-trends "RTX 4090" --full
    vastai metrics gpu-trends "RTX 4090" --raw
    vastai metrics gpu-trends all --verified true --datacenter true
    vastai metrics gpu-trends "RTX 5090" --num-gpus 8
    vastai metrics gpu-trends "RTX 4090,H100_SXM" --start 1773298800 --end 1773817200 --step 3600
```

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |