Skip to main content
POST
/
api
/
v1
/
backchannel
/
scenarios
/
batch
Batch fetch articles by point IDs
curl --request POST \
  --url https://tilt.io/api/v1/backchannel/scenarios/batch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "point_ids": [
    "<string>"
  ],
  "include_content": true
}
'
{
  "articles": [
    {
      "point_id": "<string>",
      "headline": "<string>",
      "date": "<string>",
      "content": "<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": [],
      "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
          }
        ]
      }
    }
  ],
  "total_requested": 123,
  "total_found": 123
}

Authorizations

X-Api-Key
string
header
required

Body

application/json
point_ids
string[]
required

Article point IDs to fetch (max 100)

Required array length: 1 - 100 elements
include_content
boolean
default:true

Include full article content text

Response

200 - application/json

Batch article retrieval result

articles
object[]
required
total_requested
integer
required

Number of point_ids requested

total_found
integer
required

Number of articles actually found