Skip to main content

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.