Skip to main content
POST
Create a new trading plan

Authorizations

X-API-Key
string
header
required

Organization API key (hp_live_...), sent in the X-API-Key header. Create, rotate and restrict keys in the dashboard or with the API keys endpoints; an organization can have two active keys, so you can rotate without downtime. A full-access key can call every endpoint in this reference. A read-only key can call GET endpoints (and create a trading stream token); any other request returns 403 READ_ONLY_KEY. A key with an IP allowlist returns 403 IP_NOT_ALLOWED from any other address. Each endpoint lists which keys can call it under Access.

Headers

Idempotency-Key
string

Optional. A value that identifies this operation on your side, at most 255 characters. A retry with the same key, method, path and body within 24 hours returns the original response (with Idempotency-Replayed: true) instead of repeating the change. The same key with a different body returns 409 IDEMPOTENCY_KEY_REUSED; a retry while the first request is still running returns 409 IDEMPOTENCY_KEY_IN_PROGRESS. A response that contains a credential (such as a new API key or signing secret) is not saved: the change is still not repeated, and a retry returns 409 IDEMPOTENCY_KEY_COMPLETED with the original status in originalStatus. Server errors (5xx) are not saved, so a retry runs again. If the key cannot be recorded, the request is not run and returns 503 IDEMPOTENCY_UNAVAILABLE; retry with the same key.

Maximum string length: 255

Body

application/json
name
string
required

Plan name (must be unique within your organization)

Maximum string length: 200
Example:

"100K Evaluation"

accountSize
number
required

Account size ($)

Required range: 0 <= x <= 100000000
Example:

100000

tradingRuleId
string
required

Trading rule ID to use for this plan

Example:

"660e8400-e29b-41d4-a716-446655440000"

displayName
string

Customer-facing plan name shown to traders in the trading app, up to 120 characters. When null, traders see the plan name. Omit, or send null or an empty string, to show the plan name.

Maximum string length: 120
Example:

"100K Evaluation"

description
string

Plan description

Maximum string length: 2000
Example:

"Our flagship 100K evaluation challenge"

price
number
default:0

Plan price in the plan currency. OPTIONAL — omit (or send 0) for plans that are provisioned via the API rather than sold through a checkout.

Required range: 0 <= x <= 100000000
Example:

299

currency
string
default:USD

Currency code (default: USD)

Example:

"USD"

durationDays
number

Plan duration in days. Omit or send null for unlimited duration.

Example:

30

isActive
boolean
default:true

Whether the plan is active for purchase

metadata
object

Custom metadata. At most 16 KB as JSON, 50 top-level keys and 5 levels of nesting; larger metadata returns 400 METADATA_TOO_LARGE.

Example:
markets
enum<string>[]

Markets accounts on this plan trade. Any CME Group exchange grants the full CME, CBOT, NYMEX and COMEX bundle; BINANCE adds crypto perpetuals, HYPERLIQUID adds index and commodity perpetuals and HDL adds Hyperprop Deep Liquidity crypto perpetuals (one book consolidated from several exchanges). Accounts created without their own markets use these; a plan that sets none uses the CME Group bundle. Every organization is enabled for the CME Group bundle. Perpetuals (BINANCE, HYPERLIQUID, HDL) must each be enabled for your organization by Hyperprop; until then, a request that includes one is refused with 403 MARKET_NOT_ALLOWED.

Minimum array length: 1
Available options:
CME,
CBOT,
NYMEX,
COMEX,
BINANCE,
HYPERLIQUID,
HDL
Example:

Response

Plan created successfully

success
boolean
Example:

true

message
string
Example:

"Trading plan created successfully"

data
object
Example: