---
title: "Prereg Register Ep"
method: POST
path: "/v1/prereg/register"
---

# Prereg Register Ep

`POST /v1/prereg/register`

## Request

- Base URL: `https://api.alphaassay.com`
- URL: `https://api.alphaassay.com/v1/prereg/register`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, nullable

## Request body

- PreregRegisterRequest
  - `spec` DslSpec, required
    - `dsl_version` string, required
    - `asset_universe` string[], required
    - `bar_interval` string, required
    - `target` object, required
    - `signal` object, required
    - `position` object, nullable
    - `entry_lag_bars` integer, nullable
  - `maturity_bars` integer
  - `embargo_bars` integer
  - `hypothesis` HypothesisTuple: v2 sealed success criteria; the engine validates ranges/floors.
    - `declared_pass_sharpe_annualized` number, required
    - `max_evaluation_bars` integer, required
    - `fee_bps_per_side` number
    - `trading_calendar` string
    - `rationale` string

## Response `200`

Successful Response

- RegisterOutput
  - `_meta` PublicMeta, required
    - `engine_version` string, required
    - `api_version` string, required
    - `as_of` string, date-time, required
    - `input_digest` string, required
    - `request_digest` string, required
    - `tenant_scope` string, required
    - `tenant_scope_version` string, required
    - `request_id` string, nullable, required
    - `source_identity_digest` string, required
    - `operation` string, required
    - `statefulness` 'pure' | 'public_read' | 'tenant_read' | 'tenant_write', required
    - `not_financial_advice` true, required
    - `disclaimer` string, required
  - `prereg_id` string, required
  - `family_id` string, required
  - `spec_hash` string, required
  - `anchor_hash` string, required
  - `registered_at` string, required
  - `evaluation_start_at` string, required
  - `maturity_bars` integer, required
  - `engine_version` string, required
  - `ledger_cumulative_n` integer, required
  - `created` boolean, required
  - `disclaimer` string, required
  - `status` 'registered' | 'maturing' | 'evaluated' | 'withdrawn', nullable
  - `note` string, nullable
  - `hypothesis_hash` string, nullable
  - `hypothesis` SealedHypothesis
    - `declared_pass_sharpe_annualized` union, required
      - integer
      - number
    - `max_evaluation_bars` integer, required
    - `fee_bps_per_side` union, required
      - integer
      - number
    - `trading_calendar` '24/7' | 'weekdays', required
    - `rationale` string, required

## Other responses

- `401`: Request could not be completed
- `402`: Request could not be completed
- `403`: Request could not be completed
- `409`: Request could not be completed
- `413`: Request could not be completed
- `422`: Request could not be completed
- `429`: Request rate limit exceeded
- `500`: Internal execution failure
- `503`: Request could not be completed

---

[API](https://skmtc.dev/alphaassay/apis/alphaassay-api.md) · [All operations](https://skmtc.dev/alphaassay/apis/alphaassay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphaassay/apis/alphaassay-api/revisions/cdbc99b01a7e?raw)