FAQ and troubleshooting

My prices say SIMULATED and I configured a market key.

Read market.detail in /api/deck — it names the cause rather than making you guess. In production the usual answer is rate limiting: providers limit by IP and a Worker’s egress address is shared, so a key that works locally can be throttled in deployment. The cache heals this within a few requests. Also check live, which is false if even one symbol fell back to fiction.

My watch never fires.

In order of likelihood: the market is shut, so the change since previous close is not moving and the loop is correctly quiet; the threshold is deeper than the symbol has moved; the watch is paused; or the symbol resolves to no quote. Hit Evaluate now — the per-watch outcome tells you which.

A watch tripped but no proposal appeared.

Look for a system event in the ledger. A failed draft — no model key configured, an upstream error, or a model reply that failed schema validation — writes one naming the cause, and stamps the cooldown so it cannot retry every tick.

My MCP client gets 401.

The header must be exactly Authorization: Bearer odsy_…. If it is, the token is revoked or was never valid — the server does not distinguish the two on purpose. Issue a fresh one in Settings → MCP access.

record_execution is refused.

Only approved proposals can be closed out. A pending one has not been signed off; an executed or rejected one is terminal.

I lost a deck token.

There is no recovery — only the digest is stored. Revoke it and issue another.

Everything logged out at once.

SESSION_SECRET changed, or was never set so a per-boot random secret regenerated on restart. Set a stable value.

Can an agent trade on my behalf?

Not through Oddysey. There is no execution endpoint in the system. Your own agent may well be able to trade on your own rail — that capability is yours, lives outside Oddysey, and is exactly the arrangement this product is built around.

Why is there no approve tool over MCP?

Because an agent that could approve its own drafts would defeat the entire product. Approval is the human’s job, in the deck.

Is Oddysey affiliated with Robinhood?

No. It is an independent project built on a public, permissionless network, not affiliated with, endorsed by, or sponsored by Robinhood Markets, Inc.

Are stock tokens the same as shares?

No. They are tokenized instruments that track underlying equities and do not confer direct share ownership. Availability varies by jurisdiction — check your local rules.

Which model writes the proposals?

By default deepseek/deepseek-v4-flash through OpenRouter, overridable with OPENROUTER_MODEL. The model writes prose and argues for an allocation; it computes none of the numbers.

Does Oddysey see my brokerage account?

No. It holds no brokerage credentials. The connection layer that could is deliberately switched off — see security.

Is my data mixed with other operators'?

No. Every row is scoped to your session address, and demo sessions get a fresh throwaway address each visit. The one shared table is the quote cache, because a price for NVDA is the same fact for everyone.

Is any of this investment advice?

No. A proposal is a written argument produced by a language model. It can be wrong, and reading it critically is the job the design reserves for you.