API Reference

The AI Datacenter Platform API provides programmatic access to financial indices, project data, and market intelligence for AI datacenter projects. All API requests require authentication using an API key.

Authentication

All API requests must include your API key in the X-API-Key header:

curl -X GET "https://api.yourdomain.com/v1/indices/glri" \
  -H "X-API-Key: your-api-key-here"

You can generate and manage API keys from your account settings.

Base URL

https://api.yourdomain.com/v1

Rate Limits

Free tier: 100 requests per hour
Pro tier: 1,000 requests per hour
Enterprise: Custom limits

Endpoints

Indices

GPU Lease Rate Index (GLRI)

Current and historical GPU lease rates by model and region.

Method	Endpoint	Description
`GET`	`/indices/glri`	Get GPU lease rate data

Query Parameters:

gpu_model (string) - GPU model (e.g., "H100", "A100")
region_band (string) - Geographic region (e.g., "US_East", "US_West")
as_of_date (date) - Specific date for historical data

Example Request:

curl -X GET "https://api.yourdomain.com/v1/indices/glri?gpu_model=H100&region_band=US_East" \
  -H "X-API-Key: your-api-key-here"

Time-to-Power Scores (TTPS)

Time-to-power availability scores for interconnection queues.

Method	Endpoint	Description
`GET`	`/indices/ttps`	Get time-to-power scores

Query Parameters:

queue_id (string) - Specific interconnection queue ID
iso (string) - ISO/RTO identifier
region (string) - Geographic region filter

Curtailment Stress Scores (CSS)

Curtailment stress metrics for renewable energy availability.

Method	Endpoint	Description
`GET`	`/indices/css`	Get curtailment stress scores

Power-Adjusted Yield (PAY)

Power-adjusted yield calculations for project attractiveness.

Method	Endpoint	Description
`GET`	`/indices/pay`	Get power-adjusted yield data

Data & Exports

Interconnection Queues

Access to interconnection queue data and status.

Method	Endpoint	Description
`GET`	`/queues`	List interconnection queues

CSV Exports

Export data in CSV format for analysis.

Method	Endpoint	Description
`POST`	`/exports/csv`	Request CSV export job
`GET`	`/exports/csv/{job_id}`	Get export job status

Account & Management

Watchlists

Manage project watchlists and alerts.

Method	Endpoint	Description
`GET`	`/watchlists`	List user watchlists
`POST`	`/watchlists`	Create new watchlist
`PUT`	`/watchlists/{id}`	Update watchlist
`DELETE`	`/watchlists/{id}`	Delete watchlist

Alerts

Test and manage alert configurations.

Method	Endpoint	Description
`POST`	`/alerts/test`	Send test alert

Response Format

All successful responses return JSON with the following structure:

{
  "data": [...],
  "pagination": {
    "cursor": "string",
    "has_more": boolean
  },
  "request_id": "string"
}

Error Handling

Errors return appropriate HTTP status codes with detailed error information:

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {...}
  },
  "request_id": "string"
}

Common Error Codes:

400 - Bad Request (invalid parameters)
401 - Unauthorized (invalid/missing API key)
403 - Forbidden (insufficient permissions)
429 - Rate Limited
500 - Internal Server Error

SDKs & Libraries

Official SDKs are available for:

TypeScript/JavaScript - npm install @ai-datacenter/api-client
Python - pip install ai-datacenter-api

Note: This API documentation is automatically generated from our OpenAPI specification. For the most up-to-date specification, see our OpenAPI YAML file.

Documentation