# 1Token 1ndex Public Strategy Overview API v1

The 1ndex public API provides a read-only aggregate overview of strategy categories and their historical performance data.

- Endpoint: <https://1ndex.1token.tech/api/v1/public/strategy-overview>
- OpenAPI: <https://1token.tech/api/1ndex/v1/openapi.json>
- Product page: <https://1token.tech/1ndex>

## Access and support boundary

No authentication is currently required. The endpoint is provided on a best-effort basis without an availability SLA or an advertised request quota. Keep request frequency low, cache results where appropriate, and use the optional filters to avoid repeatedly downloading the full response.

This public contract covers only the aggregate 1ndex strategy overview endpoint. It does not publish customer-specific data, write operations, CAM product interfaces, or third-party APIs consumed by 1Token.

## Request

```http
GET /api/v1/public/strategy-overview HTTP/1.1
Host: 1ndex.1token.tech
Accept: application/json
```

All query parameters are optional:

| Parameter | Type | Meaning |
| --- | --- | --- |
| `start_time` | integer (`int64`) | Start of the requested history window as a Unix timestamp in nanoseconds. |
| `end_time` | integer (`int64`) | End of the requested history window as a Unix timestamp in nanoseconds. |
| `strategy_type` | string | Strategy type filter, for example `DeltaNeutral`. Supported values are not declared as a fixed enum. |

Example with a bounded history window:

```bash
curl --get 'https://1ndex.1token.tech/api/v1/public/strategy-overview' \
  --data-urlencode 'start_time=1783900800000000000' \
  --data-urlencode 'end_time=1783987200000000000' \
  --data-urlencode 'strategy_type=DeltaNeutral' \
  --header 'Accept: application/json'
```

## Response

A successful request returns `200 application/json` with:

- `update_time` and `update_time_str`: the aggregate update time.
- `platform_statistics`: current investor, strategy, and trading-team counts.
- `strategy_types`: aggregate strategy summaries and historical time-series data.

Performance fields are the raw numeric values returned by 1ndex. This catalog does not define additional presentation, rounding, percentage, or sign conventions for those fields.

### Timestamp precision

`time` and `update_time` are Unix timestamps in nanoseconds. Their 19-digit integer values exceed JavaScript's safe-integer range. JavaScript clients should use `time_str` and `update_time_str`, which are UTC RFC 3339 timestamps, when exact time precision matters.

## Errors

Invalid filters return `400 application/json` with a stable top-level shape:

```json
{
  "code": "invalid_parameter",
  "message": "Invalid parameter: invalid start_time: expected nanosecond Unix timestamp"
}
```

For product or access questions, use the [1ndex contact link](https://calendly.com/joey-shi/30min).
