---
title: "Public Family Budget"
method: GET
path: "/v1/public/family-budget"
---

# Public Family Budget

`GET /v1/public/family-budget`

## Request

- Base URL: `https://api.alphaassay.com`
- URL: `https://api.alphaassay.com/v1/public/family-budget`
- Auth: none declared

Free budget mathematics for the site widget: where does a family's
next try die? Pure computation over the published thresholds -- reads
no family data, so identical bounded inputs produce the same result.

## Query parameters

- `n_trials` integer, required
- `sharpe_annualized` number, nullable
- `n_obs` integer, nullable
- `periods_per_year` number
- `variance_of_sharpe` number

## Response `200`

Successful Response

- FamilyBudgetResponse
  - `schema` 'family_budget.v1', required
  - `n_trials` integer, required
  - `variance_of_sharpe` number, required
  - `rejection_threshold` FamilyBudgetThreshold, required
    - `sharpe_per_obs` number, required
    - `sharpe_annualized` number, required
  - `dsr_min` number, required
  - `bh_alpha` number, required
  - `break_even_n` integer, nullable, required
  - `note` string, required

## Other responses

- `422`: Request could not be completed
- `429`: Request rate limit exceeded
- `500`: Internal execution failure

---

[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)
