Skip to main content
GET
/
api
/
v1
/
indexes
/
{index_uuid}
/
level
cURL
curl --request GET \
  --url https://api.tilt.io/api/v1/indexes/{index_uuid}/level \
  --header 'X-Api-Key: <api-key>'
{
  "index_levels": {},
  "intraday_levels": {},
  "performance_metrics": {
    "daily_returns": "<string>",
    "weekly_returns": "<string>",
    "monthly_returns": "<string>",
    "year_to_date_returns": "<string>",
    "one_year_returns": "<string>",
    "last_updated": "2023-11-07T05:31:56Z"
  },
  "benchmark": {
    "levels": {},
    "performance_metrics": {
      "daily_returns": "<string>",
      "weekly_returns": "<string>",
      "monthly_returns": "<string>",
      "year_to_date_returns": "<string>",
      "one_year_returns": "<string>",
      "last_updated": "2023-11-07T05:31:56Z"
    }
  }
}

​
Description

Retrieves the levels of a specific index identified by its UUID.

​
Parameters

​
Path Parameters

ParameterRequiredDescription
index_uuidYesThe unique identifier of the index

​
Query Parameters

ParameterRequiredDescription
start_dateNoFilter levels from this date onwards (YYYY-MM-DD). If a value before the index start date is provided, we will:
- Project starting weights back in time for backtesting
- Rebalance based on the index’s defined interval
- Normalize index level to 100 on the index start date
end_dateNoFilter levels until this date (YYYY-MM-DD)
benchmarkNoReturns a corresponding benchmark level time series. Currently supported values: SPY
time_periodNoReturns preset cached time periods of index levels. Supported values:
- 1m: Last month
- 3m: Last 3 months
- 6m: Last 6 months
- 1y: Last year
- 3y: Last 3 years
- 5y: Last 5 years
- si: Since inception

​
Default Behavior

  • If neither start_date nor time_period is provided, returns index levels since inception
  • If both time_period and start_date/end_date are provided, the time_period parameter takes precedence
  • Custom date ranges can be specified using start_date and end_date parameters

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
index_uuid
string<uuid>
required

Query Parameters

​
benchmark_symbol
enum<string>

Benchmark symbol to compare the index to.

Available options:
SPY
​
start_date
string

Start date to get the level as a backcast, in the format YYYY-MM-DD.

​
time_period
enum<string>

Time period to get the level for, where si is since inception. If set, this will override the start date.

Available options:
1m,
1y,
3m,
3y,
5y,
6m,
si

Response

200 - application/json
​
index_levels
object
required
​
intraday_levels
object
required
​
performance_metrics
object
required
​
benchmark
object