Skip to main content

​
Availability

Intent management is available on all plans.

​
Intended Purpose

Intents provide a broker-agnostic interface for submitting trading actions through Anthid. Instead of integrating directly with broker-specific order entry APIs, applications submit intents describing the desired trading action. Anthid validates, routes, tracks, and executes those requests through the appropriate broker integration while exposing a consistent platform interface. This allows applications to integrate once and operate across supported brokers without implementing broker-specific order submission logic.

​
Access

Submitting intents is authorized for API-key callers that belong to the account organization and have organization intent edit permission. Create intents on live accounts additionally require the Trading Live entitlement and must pass controls evaluation before an action and outbox record are written. Read operations require intent read access. Service-account callers must provide x-organization-id and have intent:read; API-key callers need organization intent read permission; user callers need an organization admin, member, or read-only role. Non-service callers can only read their principal organization.

​
Intent Commands

The submit endpoint appends an intent command for a trading account: Create commands include a symbol, order side, optional route strategy, and order spec. Replace commands include a replacement order spec. Cancel commands only require the referenced intent id.

​
Endpoint Groups

List endpoints return append-only action records in ascending order and support next_cursor and limit. Stats support time_window with last_day as the default when omitted.

​
Common Use Cases

  • Submit market, limit, stop, and stop-limit orders.
  • Build automated trading systems using a unified API.
  • Route orders through platform controls and risk checks.
  • Track order execution through a consistent lifecycle.
  • Support multiple brokers without maintaining separate integrations.
  • Create trading workflows that operate across paper and live environments.
  • Generate auditable records of trading activity.

​
Lifecycle

An intent represents a requested trading action. After submission, Anthid validates the request, evaluates applicable controls, appends an action record, queues broker execution, and tracks execution status throughout its lifecycle. Applications can monitor intent activity using:
  • Intent action history
  • Intent stats
  • Streaming API
  • Ledger APIs

​
Common Workflow

  1. Create a Trading Account.
  2. Submit an Intent.
  3. Anthid validates and processes the request.
  4. The request is routed to the broker.
  5. Order updates are streamed through the Streaming API.
  6. Historical activity becomes available through the Ledger APIs.
  • Trading Accounts
  • Brokers
  • Orders
  • Positions
  • Ledger
  • Streaming API
  • Controls

​
Support

For questions about authentication, request formats, or API behavior, contact support@anthid.com.