Skip to main content

Overview

Base URL

https://tilt.io

Authentication

All Backchannel API endpoints require a Bearer token. Tokens are obtained through the Tilt backend OTP authentication flow. Include the token in the header of each request:
Authorization: Bearer <your_token>
API key authentication is coming in a future release. For now, all requests must use Bearer tokens from the OTP flow.

Making Your First API Calls

1. Get User Profile

Retrieve the authenticated user’s profile:
curl -X GET "https://tilt.io/api/v1/backchannel/user/profile" \
  -H "Authorization: Bearer YOUR_TOKEN"
View full API reference →

2. Search Scenarios

Find market scenarios relevant to current conditions:
curl -X POST "https://tilt.io/api/v1/backchannel/scenarios/search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [{"weight": 1, "query": "tariffs"}],
    "limit": 5
  }'
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/macro-sensitivities" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
View full API reference →

Important Reminders

Remember to replace YOUR_TOKEN with your actual Bearer token in all requests.