over.computer

Trade on prediction markets through the over.computer API.

Use this when the operator says things like:

• - check markets
• place an order / buy / sell
• approve funds
• show my positions
• list my orders

Getting started

If OVER_API_KEY is not set, help the operator register:

Option A — agent-initiated:

1. 1. Call the link endpoint (no auth required) to obtain a registration URL:

CODEBLOCK0

This returns { "configId": "<uuid>", "url": "<registration_url>" }.

1. 2. Give the operator the url and ask them to open it, connect their wallet on over.computer, and copy the API key shown after setup.
2. Once the operator provides the key, store it as OVER_API_KEY.

Option B — operator-initiated:

1. 1. The operator goes to https://over.computer directly, registers, and obtains an API key.
2. The operator gives the key to you.

Authentication

All endpoints under /myriad/* and /agent/* require the header:

CODEBLOCK1

Get your config

Retrieve your agent’s configuration from the operator (same auth as Myriad routes):

CODEBLOCK2

Returns: { "prompt": "...", "label": "..." } (either field may be null if unset).

• - prompt — trading instructions from the operator; follow them as your directive.
• label — your agent’s display name.

Guardrails (position limits, trade limits, allowed markets, etc.) are enforced server-side and are not exposed on this endpoint. If an order violates a guardrail, the execute endpoint will reject it with a clear reason.

Browse markets

List open markets:

CODEBLOCK3

Query parameters: limit (number), page (number), state (string, default open).

Get details for a specific market:

CODEBLOCK4

Place an order

CODEBLOCK5

Body fields:

• - idempotency_key (string, required) — unique key to prevent duplicate orders
• INLINECODE15 (number, required)
• INLINECODE16 (number, required)
• INLINECODE17 ("BUY" | "SELL", required)
• INLINECODE20 (number, required) — order size in token units
• INLINECODE21 (number, optional)

A duplicate idempotency_key returns HTTP 400 with the existing order.

Check positions

CODEBLOCK6

Order history

CODEBLOCK7

Config guardrails

The operator's config may restrict what the agent can do:

• - allowedmarkets — whitelist of permitted market IDs
• maxordersize — maximum USD value per order
• maxtradesperday — daily trade limit

When a request violates a guardrail the API returns an error with a clear reason, for example:

• - INLINECODE23
• INLINECODE24
• INLINECODE25

When this happens:

1. 1. Do not retry the request.
2. Tell the operator the exact rejection reason.
3. Ask the operator to update their config at https://over.computer — only humans can change config settings.

Error reference

• - 400 — Bad request or duplicate INLINECODE27
• INLINECODE28 — Missing or invalid API key
• INLINECODE29 — Agent has no associated user or no config found
• INLINECODE30 — Resource not found
• INLINECODE31 — Server error (includes guardrail rejections wrapped in order execution)

If execution cannot proceed due to missing credentials or API errors, inform the operator and stop. Do not retry failed requests without operator confirmation.