Skip to main content
This is a design preview. The endpoints in this section are not available. The reference exists to review the proposed contract before implementation.
The API exposes the same rules-based equity construction model used by Tilt today, with a deliberately small public surface. This proposed API accepts structured construction rules and does not put Tilt Agent in the loop. To add natural-language construction to an application you operate, connect to Tilt Agent over MCP.

​
Core model

A Tilt is a persistent project for one index methodology. Its construction rules describe how to select and weight securities, and each successful evaluation saves the constituents and weights those rules produced. For developers, a bounded analogy is a GitHub repository: construction rules are source, evaluated constituent snapshots are build artifacts, and methodology history is version history. The analogy does not imply branches, forks, merges, or cloning. Evaluating a Tilt does not publish an index. The existing version_group_sqid identifies the project across versions. A uuid addresses one particular draft or published version.

​
Workflow

  1. Browse the construction catalog or search it by concept, then inspect exact fields before choosing thresholds.
  2. List universe presets and create an unevaluated draft Tilt.
  3. Resolve ticker overrides to exact tilt_asset_id values.
  4. Apply the methodology. Tilt saves the rules, evaluates them, and commits the complete weighted constituent snapshot atomically.
  5. Read the saved constituents or backtest the saved Tilt.
Applying construction is the evaluation operation. A separate evaluation endpoint and named-index membership endpoint are outside the initial API scope.

​
Scope

The preview includes the documented rules-based equity pipeline: universe, derived fields, selection, sizing, ticker overrides, rebalance cadence, concentration limits, complete weighted constituents, and synchronous backtesting. It excludes natural-language construction, research, enrichment creation, discretionary and event-contract Tilts, publication, and governance.

Build and backtest a Tilt

Follow the complete API workflow with requests and responses.

Connect to Tilt Agent over MCP

Delegate natural-language investment tasks from an application you operate.

Create a Tilt

Create an unevaluated rules-based equity draft.

Apply construction

Save and evaluate the construction methodology.

Get constituents

Read the complete saved result with scores and weights.

List the catalog

Browse every field and supported trailing-window capability.

Search the catalog

Find fields by name or concept.