---
title: "Plain English → structured strategy (bills one LLM parse)"
method: POST
path: "/v1/parse"
---

# Plain English → structured strategy (bills one LLM parse)

`POST /v1/parse`

## Request

- Base URL: `https://app.texttoquant.com/api`
- URL: `https://app.texttoquant.com/api/v1/parse`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Request body

- object
  - `query` string, required
  - `customIndicatorHints` string[]: Saved custom indicator names referenced in the query (see GET /v1/indicators).

## Response `200`

Success

- object
  - `success` true, required
  - `data` ParsedQuery, required: The structured strategy returned by POST /v1/parse: pass verbatim to POST /v1/backtests.

## Other responses

- `422`: clarification_needed | missing_parameters | invalid_strategy — nothing billed

---

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