Quick Start - Tilt Pro API

Overview

Base URL

https://tilt.io

Authentication

All public Backchannel API endpoints require an API key. Include the API key in the header of each request:

X-Api-Key: <your_api_key>

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

Making Your First API Calls

1. Search Scenarios

Search for relevant market scenarios:

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 →

2. Get Scenario Detail

Fetch a single scenario by ID:

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 →

3. Get Macro Sensitivities

Analyze how macro factors affect a portfolio:

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 →

Public v1 Scope

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.

Introduction Scenario Analysis Guide

​Overview

​Base URL

​Authentication

​Making Your First API Calls

​1. Search Scenarios

​2. Get Scenario Detail

​3. Get Macro Sensitivities

​Public v1 Scope

Overview

Base URL

Authentication

Making Your First API Calls

1. Search Scenarios

2. Get Scenario Detail

3. Get Macro Sensitivities

Public v1 Scope