v2 Auto

Conditional query builder and runner: create, validate, poll, and stream EQL queries, and manage LLM sessions.

Required Sequence (Enforced)

1. POST /v2/auto/queries/validate
2. POST /v2/auto/queries
3. POST /v2/auto/queries/{queryId}/cancel (only while status is active)
4. DELETE /v2/auto/queries/{queryId} (only after status is terminal: triggered, expired, cancelled, failed)

If actions include market_order or limit_order, preflight GET /v2/auto/exchanges before create.

Intent Routing (Strict)

User intent	Required source	Required fields
Account-anchored post intent (@user posted ...)	source: "tweet"	args.username (no @), args.text, args.minConfidence (start at 80)
World event intent (ETF approved, exploit, sanctions)	source: "news"	args.text, args.minConfidence (start at 80)
Fuzzy world-state predicate not naturally post/event matching	source: "llm"	method: "athena_condition", args.query, args.period (>= 1h)

Endpoints	Description
Builder Chat	Ask the AI to help you build an EQL query. POST/v2/auto/chat
Validate Query	Validate EQL syntax and get a cost estimate without creating a query. Returns simulation-based cost details when the query is valid. POST/v2/auto/queries/validate
Create Query	Create and activate a conditional query. POST/v2/auto/queries
Poll Query	Check query status and execution results. GET/v2/auto/queries/{queryId}
Cancel Query	Cancel an active query. POST/v2/auto/queries/{queryId}/cancel
Delete Query	Delete a terminal query. DELETE/v2/auto/queries/{queryId}
Stream Notifications	Stream notifications for a single query via Server-Sent Events (SSE). GET/v2/auto/queries/{queryId}/stream
Stream All Notifications	Stream notifications for **all** of your queries over a single connection (SSE). GET/v2/auto/queries/stream
List LLM Sessions	List LLM output sessions for a query. Only relevant for queries with `actions[0].type: "llm"`. GET/v2/auto/queries/{queryId}/sessions
LLM Session Details	Get full LLM analysis output for a specific session. GET/v2/auto/queries/{queryId}/sessions/{sessionId}
Validate Symbol	Check whether a symbol is supported on the given exchange. GET/v2/auto/validate-symbol/{exchange}/{symbol}
List Queries	List Auto queries for the authenticated API-key user. GET/v2/auto/queries
List Query Drafts	List editable query drafts. GET/v2/auto/queries/drafts
Upsert Query Draft	Create or update a query draft. POST/v2/auto/queries/drafts
Get Query Draft	Get a specific query draft (legacy; prefer GET /queries/{queryId} which resolves query or draft). GET/v2/auto/queries/drafts/{draftId}
Delete Query Draft	Delete a query draft. DELETE/v2/auto/queries/drafts/{draftId}
Validate Query Draft	Validate a stored query draft without converting it. POST/v2/auto/queries/drafts/{draftId}/validate
Convert Query Draft	Convert a draft into an active query. POST/v2/auto/queries/drafts/{draftId}/convert
List Executions	List execution records. GET/v2/auto/executions
Get Execution	Get a single execution record. GET/v2/auto/executions/{executionId}
List Exchanges	List connected exchanges. GET/v2/auto/exchanges
Connect Exchange	Connect an exchange integration. POST/v2/auto/exchanges
Disconnect Exchange	Disconnect an exchange integration. DELETE/v2/auto/exchanges/{exchange}