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

# Quick Start

> Authenticate and start making Backchannel API calls

## Overview

### Base URL

```bash theme={null}
https://tilt.io
```

### Authentication

All public Backchannel API endpoints require an API key.

Include the API key in the header of each request:

```bash theme={null}
X-Api-Key: <your_api_key>
```

<Note>
  Reuse your existing Tilt Pro API key. Backchannel does not issue a separate key type in v1.
</Note>

## Making Your First API Calls

### 1. Search Scenarios

Search for relevant market scenarios:

```bash theme={null}
curl -X POST "https://tilt.io/api/v1/backchannel/scenarios/search" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [{"weight": 1, "query": "tariffs"}],
    "limit": 5
  }'
```

[View full API reference →](/api-reference/backchannel/search-scenarios)

### 2. Get Scenario Detail

Fetch a single scenario by ID:

```bash theme={null}
curl -X POST "https://tilt.io/api/v1/backchannel/scenarios/POINT_ID" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include_content": true
  }'
```

[View full API reference →](/api-reference/backchannel/get-scenario)

### 3. Get Macro Sensitivities

Analyze how macro factors affect a portfolio:

```bash theme={null}
curl -X POST "https://tilt.io/api/v1/backchannel/risk/sensitivities" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tilt_ids": ["Q2YN1N-R"],
    "limit": 10
  }'
```

[View full API reference →](/api-reference/backchannel/get-macro-sensitivities)

### Public v1 Scope

<Note>
  The public Backchannel API is limited to scenarios, topics, company search, company news, and risk analysis. End-user account, holdings, brokerage, and mobile-only endpoints are not part of the public contract.
</Note>
