FAQ and troubleshooting

Why did a route return 404?

The route may be hidden by market mode. Scalar mode hides /v1/binary/*. Binary mode hides several scalar market and scalar trading routes.

Call /v1/runtime-config, then call the metadata endpoint for the market family you want.

Why was access denied?

If waitlist access is enabled, protected routes require:

A valid JWT.
A wallet identity when the route needs a wallet.
Allowed access for the wallet or identity.

Use /v1/access/self to inspect the current state.

Why was my binary entry rejected?

Common reasons:

The asset is not in TRADING phase.
The market is paused.
The bucket is too close to settlement.
Leverage has not been set to 2.
Oracle or book data is stale.

Refresh /v1/binary/status and /v1/binary/bucket.

Why did my scalar order fail?

Check:

The active asset from /v1/bucket.
The book from /v1/book.
Whether the order increases exposure during close-only state.
Signature timestamp and nonce.
Decimal precision on price and size.

Why did an outcome submit fail after prepare?

Prepared actions expire and are tied to the returned canonical payload. Prepare again, sign the new message, and submit the new orderId and actionHash.

Why is an outcome route unavailable?

Outcome routes are registered only when outcomes are enabled. Check /v1/runtime-config; if outcomes_enabled is false, hide outcome flows and do not call outcome routes.

When outcome writes are enabled, prepare routes require JWT authentication, RIPBET allowlist access, and an active approved agent wallet. If prepare returns agent_not_approved, call POST /v1/agent/approve first, then retry.

Why is the book unavailable?

The API serves book data from a live market-data cache. If the cache is missing or stale, the endpoint can return 404 or 503. Do not synthesize a book on the client.

Can I use `/v1/cancel`?

Do not treat scalar /v1/cancel as a public user endpoint. The current router protects it with the admin guard. Outcome cancels have public prepare/submit endpoints under /v1/outcomes/cancel/*.

Are outcome markets always live?

No. Check /v1/runtime-config. Only show outcome trading when outcomes_enabled is true.