> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlas API

> Access GPU pricing data, market intelligence, and cost optimization through the Atlas API

# Atlas API

Access comprehensive GPU pricing data, market trends, and cost optimization insights through the Visent Atlas API. Query real-time pricing, historical trends, and get cost recommendations for GPU infrastructure planning.

Supports flexible filtering by provider, region, GPU type, and time ranges with detailed market analytics.

## Base URL

```
https://api.visent.ai/atlas
```

## Pricing Endpoints

### Current Pricing

```bash theme={null}
# Get current H100 pricing
GET /pricing/current

# Example request
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.visent.ai/atlas/pricing/current?gpu=h100&region=us-east-1&provider=aws"

# Example response
{
  "pricing": {
    "gpu": "h100",
    "provider": "aws",
    "region": "us-east-1",
    "instance_type": "p4d.24xlarge",
    "price_per_hour": 32.77,
    "currency": "USD",
    "timestamp": "2024-01-15T10:30:00Z",
    "availability": "available"
  }
}
```

### Historical Pricing

```bash theme={null}
# Get pricing trends
GET /pricing/historical

# Example with time range
GET /pricing/historical?gpu=a100&start=2024-01-01&end=2024-01-31
```

### Price Forecasting

Coming soon - predictive pricing analysis and forecasting endpoints.

## Market Intelligence

### Market Trends

```bash theme={null}
# Get market trend analysis
GET /market/trends

# Regional demand analysis
GET /market/demand?region=us-west-2&period=30d
```

### Supply Analysis

Coming soon - GPU availability and supply constraint data.

### Competitive Analysis

Coming soon - provider pricing comparison and market positioning.

## Cost Optimization

### Recommendations

```bash theme={null}
# Get cost optimization suggestions
POST /optimization/recommendations

# Request body
{
  "workload": "ml-training",
  "budget": 10000,
  "duration": "30d",
  "requirements": {
    "min_gpus": 8,
    "memory_per_gpu": "80GB"
  }
}
```

### Savings Calculator

Coming soon - calculate potential savings with different configurations.

## Query Parameters

### Common Parameters

* `gpu`: GPU model (h100, a100, v100, etc.)
* `provider`: Cloud provider (aws, gcp, azure)
* `region`: Geographic region
* `start_date`: Start date for historical queries
* `end_date`: End date for historical queries

Coming soon - complete parameter reference and validation rules.

## Response Format

Coming soon - detailed API response schemas and data models.

## Rate Limits

Coming soon - API rate limiting and usage policies.

## Error Handling

Coming soon - error codes and troubleshooting guide.

## Code Examples

### Python

```python theme={null}
import requests

# Get current pricing
response = requests.get(
    "https://api.visent.ai/atlas/pricing/current",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"gpu": "h100", "provider": "aws"}
)
pricing = response.json()
```

### JavaScript

Coming soon - JavaScript integration examples.

## Next Steps

* [Review authentication setup](authentication) for API access
* [Explore Telemetry API](telemetry) for monitoring data
* [Use Python SDK](../sdk/python) for simplified integration