cURL
curl --request POST \
--url https://tilt.io/api/v1/backchannel/scenarios/search \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"queries": [
{
"weight": 0.5,
"query": "<string>"
}
],
"subject_code": "<string>",
"limit": 10,
"offset": 0,
"min_score": 0.4,
"include_content": false,
"min_importance": 5,
"importance_weight": 0,
"topic": "<string>",
"portfolio_weights": {},
"aggregate_scenarios": false,
"order_by_exposure": false,
"seen_image_ids": [
"<string>"
],
"seen_window": 123,
"viewer_user_id": "<string>"
}
'import requests
url = "https://tilt.io/api/v1/backchannel/scenarios/search"
payload = {
"queries": [
{
"weight": 0.5,
"query": "<string>"
}
],
"subject_code": "<string>",
"limit": 10,
"offset": 0,
"min_score": 0.4,
"include_content": False,
"min_importance": 5,
"importance_weight": 0,
"topic": "<string>",
"portfolio_weights": {},
"aggregate_scenarios": False,
"order_by_exposure": False,
"seen_image_ids": ["<string>"],
"seen_window": 123,
"viewer_user_id": "<string>"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
queries: [{weight: 0.5, query: '<string>'}],
subject_code: '<string>',
limit: 10,
offset: 0,
min_score: 0.4,
include_content: false,
min_importance: 5,
importance_weight: 0,
topic: '<string>',
portfolio_weights: {},
aggregate_scenarios: false,
order_by_exposure: false,
seen_image_ids: ['<string>'],
seen_window: 123,
viewer_user_id: '<string>'
})
};
fetch('https://tilt.io/api/v1/backchannel/scenarios/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tilt.io/api/v1/backchannel/scenarios/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'queries' => [
[
'weight' => 0.5,
'query' => '<string>'
]
],
'subject_code' => '<string>',
'limit' => 10,
'offset' => 0,
'min_score' => 0.4,
'include_content' => false,
'min_importance' => 5,
'importance_weight' => 0,
'topic' => '<string>',
'portfolio_weights' => [
],
'aggregate_scenarios' => false,
'order_by_exposure' => false,
'seen_image_ids' => [
'<string>'
],
'seen_window' => 123,
'viewer_user_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://tilt.io/api/v1/backchannel/scenarios/search"
payload := strings.NewReader("{\n \"queries\": [\n {\n \"weight\": 0.5,\n \"query\": \"<string>\"\n }\n ],\n \"subject_code\": \"<string>\",\n \"limit\": 10,\n \"offset\": 0,\n \"min_score\": 0.4,\n \"include_content\": false,\n \"min_importance\": 5,\n \"importance_weight\": 0,\n \"topic\": \"<string>\",\n \"portfolio_weights\": {},\n \"aggregate_scenarios\": false,\n \"order_by_exposure\": false,\n \"seen_image_ids\": [\n \"<string>\"\n ],\n \"seen_window\": 123,\n \"viewer_user_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://tilt.io/api/v1/backchannel/scenarios/search")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"queries\": [\n {\n \"weight\": 0.5,\n \"query\": \"<string>\"\n }\n ],\n \"subject_code\": \"<string>\",\n \"limit\": 10,\n \"offset\": 0,\n \"min_score\": 0.4,\n \"include_content\": false,\n \"min_importance\": 5,\n \"importance_weight\": 0,\n \"topic\": \"<string>\",\n \"portfolio_weights\": {},\n \"aggregate_scenarios\": false,\n \"order_by_exposure\": false,\n \"seen_image_ids\": [\n \"<string>\"\n ],\n \"seen_window\": 123,\n \"viewer_user_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://tilt.io/api/v1/backchannel/scenarios/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"queries\": [\n {\n \"weight\": 0.5,\n \"query\": \"<string>\"\n }\n ],\n \"subject_code\": \"<string>\",\n \"limit\": 10,\n \"offset\": 0,\n \"min_score\": 0.4,\n \"include_content\": false,\n \"min_importance\": 5,\n \"importance_weight\": 0,\n \"topic\": \"<string>\",\n \"portfolio_weights\": {},\n \"aggregate_scenarios\": false,\n \"order_by_exposure\": false,\n \"seen_image_ids\": [\n \"<string>\"\n ],\n \"seen_window\": 123,\n \"viewer_user_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"articles_found": 123,
"articles": [
{
"point_id": "<string>",
"headline": "<string>",
"date": "<string>",
"content": "<string>",
"publication_time": "<string>",
"tilt_source": "",
"importance_rating": 0,
"importance_rationale": "",
"generated_at": "",
"article_image_url": "<string>",
"fallback_image_id": "<string>",
"timeline": [],
"scenarios": [],
"subject_codes": [],
"subject_codes_original": [],
"prediction_markets": [],
"score": 123,
"tilt_asset_ids": [],
"securities": [],
"portfolio_exposure": {
"mad_pct": 123,
"expected_return_pct": 123,
"num_leaf_scenarios": 123,
"leaf_details": [
{
"path": [
"<string>"
],
"title": "<string>",
"joint_probability_pct": 123,
"portfolio_return_pct": 123,
"abs_portfolio_return_pct": 123
}
],
"scenario_level_details": [
{
"title": "<string>",
"description": "<string>",
"probability_pct": 123,
"portfolio_return_mean_pct": 123,
"portfolio_return_std_pct": 123,
"macro_shocks": [
{
"indicator": "<string>",
"mean": 123,
"std": 123
}
],
"sub_scenario_count": 123
}
]
},
"warnings": [
"<string>"
]
}
],
"has_more": false,
"next_offset": 123
}Scenario Analysis
Search Scenarios
POST
/
api
/
v1
/
backchannel
/
scenarios
/
search
cURL
curl --request POST \
--url https://tilt.io/api/v1/backchannel/scenarios/search \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"queries": [
{
"weight": 0.5,
"query": "<string>"
}
],
"subject_code": "<string>",
"limit": 10,
"offset": 0,
"min_score": 0.4,
"include_content": false,
"min_importance": 5,
"importance_weight": 0,
"topic": "<string>",
"portfolio_weights": {},
"aggregate_scenarios": false,
"order_by_exposure": false,
"seen_image_ids": [
"<string>"
],
"seen_window": 123,
"viewer_user_id": "<string>"
}
'import requests
url = "https://tilt.io/api/v1/backchannel/scenarios/search"
payload = {
"queries": [
{
"weight": 0.5,
"query": "<string>"
}
],
"subject_code": "<string>",
"limit": 10,
"offset": 0,
"min_score": 0.4,
"include_content": False,
"min_importance": 5,
"importance_weight": 0,
"topic": "<string>",
"portfolio_weights": {},
"aggregate_scenarios": False,
"order_by_exposure": False,
"seen_image_ids": ["<string>"],
"seen_window": 123,
"viewer_user_id": "<string>"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
queries: [{weight: 0.5, query: '<string>'}],
subject_code: '<string>',
limit: 10,
offset: 0,
min_score: 0.4,
include_content: false,
min_importance: 5,
importance_weight: 0,
topic: '<string>',
portfolio_weights: {},
aggregate_scenarios: false,
order_by_exposure: false,
seen_image_ids: ['<string>'],
seen_window: 123,
viewer_user_id: '<string>'
})
};
fetch('https://tilt.io/api/v1/backchannel/scenarios/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tilt.io/api/v1/backchannel/scenarios/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'queries' => [
[
'weight' => 0.5,
'query' => '<string>'
]
],
'subject_code' => '<string>',
'limit' => 10,
'offset' => 0,
'min_score' => 0.4,
'include_content' => false,
'min_importance' => 5,
'importance_weight' => 0,
'topic' => '<string>',
'portfolio_weights' => [
],
'aggregate_scenarios' => false,
'order_by_exposure' => false,
'seen_image_ids' => [
'<string>'
],
'seen_window' => 123,
'viewer_user_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://tilt.io/api/v1/backchannel/scenarios/search"
payload := strings.NewReader("{\n \"queries\": [\n {\n \"weight\": 0.5,\n \"query\": \"<string>\"\n }\n ],\n \"subject_code\": \"<string>\",\n \"limit\": 10,\n \"offset\": 0,\n \"min_score\": 0.4,\n \"include_content\": false,\n \"min_importance\": 5,\n \"importance_weight\": 0,\n \"topic\": \"<string>\",\n \"portfolio_weights\": {},\n \"aggregate_scenarios\": false,\n \"order_by_exposure\": false,\n \"seen_image_ids\": [\n \"<string>\"\n ],\n \"seen_window\": 123,\n \"viewer_user_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://tilt.io/api/v1/backchannel/scenarios/search")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"queries\": [\n {\n \"weight\": 0.5,\n \"query\": \"<string>\"\n }\n ],\n \"subject_code\": \"<string>\",\n \"limit\": 10,\n \"offset\": 0,\n \"min_score\": 0.4,\n \"include_content\": false,\n \"min_importance\": 5,\n \"importance_weight\": 0,\n \"topic\": \"<string>\",\n \"portfolio_weights\": {},\n \"aggregate_scenarios\": false,\n \"order_by_exposure\": false,\n \"seen_image_ids\": [\n \"<string>\"\n ],\n \"seen_window\": 123,\n \"viewer_user_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://tilt.io/api/v1/backchannel/scenarios/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"queries\": [\n {\n \"weight\": 0.5,\n \"query\": \"<string>\"\n }\n ],\n \"subject_code\": \"<string>\",\n \"limit\": 10,\n \"offset\": 0,\n \"min_score\": 0.4,\n \"include_content\": false,\n \"min_importance\": 5,\n \"importance_weight\": 0,\n \"topic\": \"<string>\",\n \"portfolio_weights\": {},\n \"aggregate_scenarios\": false,\n \"order_by_exposure\": false,\n \"seen_image_ids\": [\n \"<string>\"\n ],\n \"seen_window\": 123,\n \"viewer_user_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"articles_found": 123,
"articles": [
{
"point_id": "<string>",
"headline": "<string>",
"date": "<string>",
"content": "<string>",
"publication_time": "<string>",
"tilt_source": "",
"importance_rating": 0,
"importance_rationale": "",
"generated_at": "",
"article_image_url": "<string>",
"fallback_image_id": "<string>",
"timeline": [],
"scenarios": [],
"subject_codes": [],
"subject_codes_original": [],
"prediction_markets": [],
"score": 123,
"tilt_asset_ids": [],
"securities": [],
"portfolio_exposure": {
"mad_pct": 123,
"expected_return_pct": 123,
"num_leaf_scenarios": 123,
"leaf_details": [
{
"path": [
"<string>"
],
"title": "<string>",
"joint_probability_pct": 123,
"portfolio_return_pct": 123,
"abs_portfolio_return_pct": 123
}
],
"scenario_level_details": [
{
"title": "<string>",
"description": "<string>",
"probability_pct": 123,
"portfolio_return_mean_pct": 123,
"portfolio_return_std_pct": 123,
"macro_shocks": [
{
"indicator": "<string>",
"mean": 123,
"std": 123
}
],
"sub_scenario_count": 123
}
]
},
"warnings": [
"<string>"
]
}
],
"has_more": false,
"next_offset": 123
}Authorizations
Body
application/json
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Minimum string length:
1Required range:
1 <= x <= 100Required range:
x >= 0Required range:
0 <= x <= 1Required range:
1 <= x <= 10Required range:
0 <= x <= 2Minimum string length:
1Portfolio weights keyed by tilt_id or CUSIP. Mixed identifiers are allowed; CUSIPs are resolved to tilt_ids server-side.
Show child attributes
Show child attributes
Minimum string length:
1⌘I