One question, one API: given the trade options in front of you right now, which should you take, at what size, and what profit should you expect? Everything here is built to be driven by your agent — or by you.
The P34 API. GET / lists capabilities, and POST /validate checks inputs without a key. Free workspace keys support fits for markets supported by the free tier, and mock: true input testing for any market. Other markets require membership.
ConsoleThe management console: registration and login, API keys, plans & billing, business profile, live session status and cancel.
SimulatorThe market simulator: play a synthetic market in your browser with P34 predictions — sliders for demand and economics, week-by-week capital.
Tables travel as JSON records or base64 Parquet. An optional confidence_correction in [−1, 1] tilts selection: positive = fewer, higher-confidence picks; negative = more scenarios.
# pip install pandas requests pyarrow import requests API = "https://api.hyperc.com/v1" H = {"Authorization": "Bearer $P34_API_KEY"} r = requests.post(f"{API}/fit", headers=H, json={ "menus": menus, # history + the T=0 task menu "sales": sales, # realized sales event tape "market_type": config, # holding costs, write-offs, fees "model": "rc012"}) sid = r.json()["session_id"] res = requests.get(f"{API}/result/{sid}", headers=H).json() # status: queued → processing → done | failed # done ⇒ selected qty + predicted profit per key, # n_selected, predicted_profit_sum
Base URL: https://api.hyperc.com/v1 · Auth: Authorization: Bearer <key>
| Endpoint | What it does |
|---|---|
| GET / | Service info: protocol, available model versions, endpoint list. Open. |
| GET /health | Liveness probe. Open. |
| POST /fit | Submit your market description and available data. Returns a session_id; poll /result/{session_id} for the portfolio. Free fits are available for markets supported by the free tier. Use mock: true only to test inputs before submitting an actual fit or prediction; input testing works on every tier. |
| GET /result/{session_id} | Poll until done or failed; a request may pass through grounding, queued and processing. Read the returned portfolio menu, selected quantities and profit fields. |
| POST /predict | Instant selection from a small in-process reference model — a payload sanity-checker while the real calculation runs. Not P34's answer; /result is. |
The task menu must carry no outcome values — P34 never sees your future. And the service refuses histories that are all wins: declined-deal context is a mandatory training input, not a nicety.
GET / lists offered versions (e.g. r008, rc012, rc012-ray). The chosen version runs the whole calculation and is echoed in the response.
Compute budgets scale with your plan and show as percentage used. Weekly and rolling five-hour windows apply; request size caps at 300 MB.
Everything is public at github.com/hyperc-ai/P34-API-DOCS — docs, runnable examples, sample data and a CI-ready test workflow.
| Path | Contents |
|---|---|
| docs/01-overview.md | What P34 does and the mental model: menus, sales, the T=0 task, why not just a regressor. |
| docs/02-endpoints.md | Endpoint reference, auth, result statuses, model versions, confidence correction, wire formats, limits. |
| docs/03-data-format.md | The Menus / Sales / market_type input format, rule by rule — including “include the deals you did not take.” |
| docs/04-errors-and-checks.md | Common validation errors and quick self-checks. |
| examples/client/ | A complete sample client: fit → poll → portfolio, with JSON/Parquet wire helpers. |
| examples/data/ | Sample input as Excel, CSV and JSON. |
| examples/pytest/ | A minimal pytest workflow to validate your integration in CI. |
| examples/baseline_comparison/ | P34 vs a gradient-boosting profit regressor on a synthetic market with known ground truth. |
The public P34 repositories. Simulator and Arena repositories are coming soon.
Complete user-facing P34 API documentation: endpoint reference, data format, examples, pytest workflow, baseline comparison.
P34 Technical Report and results discussion — benchmark notebooks behind “Learning When Not to Trade.”
The market-simulator repository and the PARML Arena are being prepared for publication.
Use of the API, console and simulator is governed by the P34 API Terms of Use (effective 2026-07-20), presented at registration in the console. They cover the plan and its fees, the accumulating token wallet — monthly accrual, carry-over, what consumes tokens, and transfers between accounts — profit-share pricing, regulated-market classification, acceptable use, data handling and liability.
Read the API Terms in the console →
Membership Terms of Use (this site) →
The Membership Terms govern the membership program (community, opportunity feed, founding economics); the API Terms govern the API service itself. Where you use both, both apply.