# Felix

> Non-custodial trading infrastructure for AI agents: one API and one MCP server for market data, research, backtests, and owner-authorized execution across five market types.

Felix gives an AI agent, or the application that hosts one, a single account for researching markets, testing strategies, and placing real-money orders across crypto perpetuals, equity perpetuals, spot, options, and prediction markets. Order sizes are always in USD. Funds stay in a wallet the owner controls: Felix prepares transactions and receives signatures, never the private key.

API version 2.0.178. MCP package felix-mcp 2.0.110.
Base URL: https://api.felix.trade. Send `Authorization: Bearer fk_<token>` on authenticated requests.

## Operating contract

1. Every executed order uses real money and needs an owner-authorized live key.
2. Preview before execution. Read the minimum size, fee, liquidity, and round-trip risk from the preview, never from memory.
3. Put a stable `Idempotency-Key` on every mutation.
4. Reuse that key only for an exact retry of the same intent. Never rotate a key to get past an ambiguous result.
5. An error can follow a real fill. Reconcile positions and fills before retrying.
6. A timeout in a money workflow means unknown or still settling, not failed.
7. Treat an unavailable balance as unknown, never zero.
8. Honor `Retry-After` on 429. A throttle is not a revoked key; do not rotate credentials to bypass it.
9. Keep owner keys, API keys, signatures, signed transactions, and intent tokens out of prompts, logs, screenshots, feedback, and source control.
10. Research and backtests never authorize or place an order.
11. For a checkpointed autonomous redemption, `reconcile_required` means observe the existing intent. Never submit a replacement close.

## Authority and limits

Limits have two layers, and neither can be raised in place.

- **Wallet policy.** Per-operation, daily, and lifetime ceilings are chosen when the account is created and are immutable afterwards. `update_wallet_policy` supports `pause`, `resume`, `renew`, and `lockdown`; it cannot change those ceilings.
- **API-key caps.** The owner chooses a live key's per-order, daily-notional, and daily-loss caps when minting it. They must fit inside the wallet policy. Existing caps are not edited: revoke the key and mint a replacement with different caps inside the same ceiling.
- **Higher limits.** To trade above an account's ceiling, create a new account with the intended ceilings and move funds through the ordinary withdrawal and deposit flows.

Neither an API key, a `manage` key, a compromised manager, nor Felix can escalate an existing account's signed authority. Felix still enforces available balance, venue liquidity, explicit leverage intent, and signed transaction scope on every order.

## Overview

- [Introduction](https://felix.trade/docs): Non-custodial trading infrastructure for AI agents: one API and one MCP server for market data, research, backtests, and owner-authorized execution across five market types.
- [How Felix works](https://felix.trade/docs/overview/how-felix-works): The parts of a Felix account and how a request moves from an agent, through owner authorization, to a venue and back.
- [Supported markets](https://felix.trade/docs/overview/supported-markets): The market types Felix normalizes, how to write an instrument, which venue executes it, and how to check what is live right now.
- [Fees](https://felix.trade/docs/overview/fees): Felix execution fees by market type, tier discounts, when fees are collected, and the network and venue costs that apply to moving money.
- [Security and custody](https://felix.trade/docs/overview/security): What stays under the owner's control, how trading limits are layered and fixed, which emergency controls exist, and how to handle secrets.
- [Release state and versions](https://felix.trade/docs/overview/release-state): Which Felix components are live, how versions are numbered and checked at runtime, and what this documentation is generated from.

## Quickstarts

- [MCP quickstart](https://felix.trade/docs/quickstart/mcp): Install the Felix MCP server, establish an owner identity on your machine, create an owner-controlled real-money account, and place a small previewed order from your AI client.
- [API quickstart](https://felix.trade/docs/quickstart/api): Register an account with your own signer, quote and preview a market with curl, and understand what has to happen before the first live order.

## Guides

- [Connect an MCP client](https://felix.trade/docs/guides/connect-an-mcp-client): Register the pinned felix-mcp package with Claude Code, Claude Desktop, Cursor, or Codex, and give a non-MCP model the API contract instead.
- [Register with your own signer](https://felix.trade/docs/guides/register-with-your-own-signer): Deploy the owner-controlled policy wallet from an application that holds its own EVM key, validating every prepared field before signing.
- [Create child accounts](https://felix.trade/docs/guides/create-child-accounts): Create isolated child accounts under a manage key, select them safely from an MCP session, list them, and archive the ones you no longer use.
- [Mint a live key](https://felix.trade/docs/guides/mint-a-live-key): Turn owner-signed caps into an API key that can place real-money orders, and understand how scopes and caps relate to the wallet policy.
- [Fund a venue](https://felix.trade/docs/guides/fund-a-venue): Move money from the owner wallet to a venue with owner-signed transactions, read the money map first, and resume an interrupted funding safely.
- [Place an order](https://felix.trade/docs/guides/place-an-order): Preview, place, batch, cancel, and close orders on crypto, equity perpetual, spot, and option markets, and reconcile an ambiguous result before retrying.
- [Trade prediction markets](https://felix.trade/docs/guides/trade-prediction-markets): Set up the client-owned prediction-market wallet, place client-signed orders through prepare, checkpoint, submit, and commit, and size orders so the venue accepts them.
- [Set an exit plan](https://felix.trade/docs/guides/set-an-exit-plan): Attach a server-monitored stop loss, take profit, trailing stop, break-even rule, or maximum holding time to a position, and know what such a plan can and cannot guarantee.
- [Bring money home](https://felix.trade/docs/guides/bring-money-home): Return venue collateral to the owner wallet, venue by venue, with the costs, minimums, and two-stage paths each one involves.
- [Withdraw](https://felix.trade/docs/guides/withdraw): Authorize a withdrawal destination with an owner signature, withdraw with a locally signed transaction, and choose the right token for the receiving wallet.
- [Write a strategy](https://felix.trade/docs/guides/write-a-strategy): Author a think(ctx) strategy by hand for the Felix sandbox, using the decision schema, the runtime data methods, and the safety rules the runner enforces.
- [Run a backtest](https://felix.trade/docs/guides/run-a-backtest): Test a strategy on real historical bars, synchronously or as a durable operation, and read the result for what it does and does not prove.
- [Deploy an agent](https://felix.trade/docs/guides/deploy-an-agent): Run a tested strategy as a live or paper agent with an explicit budget and market list, fund the autonomous prediction-market wallet, and operate the fleet with events instead of polling.
- [Stream market data](https://felix.trade/docs/guides/stream-market-data): Subscribe to normalized quotes, books, and trades over the read-only WebSocket with one-time tickets, and handle coalescing, gaps, and reconnects correctly.
- [Receive webhooks](https://felix.trade/docs/guides/receive-webhooks): Register an HTTPS endpoint for fill, position, and agent events, verify the HMAC signature on every delivery, and treat deliveries as signals rather than truth.
- [Upgrade to Pro](https://felix.trade/docs/guides/upgrade-to-pro): Read the plan you are on, pay for 30 days of Pro with one owner-signed Polygon USDC transfer, and recover an interrupted confirmation without paying twice.
- [Recover from interruptions](https://felix.trade/docs/guides/recover-from-interruptions): What to do after a timeout, an unknown result, or a restart in the middle of an order or a money workflow, so a retry never becomes a duplicate.
- [Agent operating rules](https://felix.trade/docs/guides/agent-operating-rules): The operating loop and the rules that keep an automated strategy from double-filling, guessing instruments, or treating an unknown balance as zero.
- [Get support](https://felix.trade/docs/guides/get-support): Open an encrypted, account-scoped support ticket or feedback report from an agent or an application, with the identifiers that let Felix help and without any secret.

## API reference

- [API overview](https://felix.trade/docs/api/overview): Base URL, request and response conventions, headers, and how the reference pages that follow are generated from the deployed contract.
- [Authentication](https://felix.trade/docs/api/authentication): How to send an API key, what each scope allows, the kinds of keys Felix issues, and the ownership boundary every request is checked against.
- [Idempotency](https://felix.trade/docs/api/idempotency): The Idempotency-Key header, the key format, what a replay returns, how conflicts and unknown sends are reported, and why a money workflow key is durable state.
- [Errors](https://felix.trade/docs/api/errors): The error envelope, HTTP statuses, the stable error codes, and the recovery action each code that agents meet in practice calls for.
- [Rate limits](https://felix.trade/docs/api/rate-limits): Per-minute limits by bucket and tier, the headers that report them, durable daily quotas, and how the limiter behaves when its store is unavailable.
- [Pagination](https://felix.trade/docs/api/pagination): How list endpoints page with cursors and limits, and how to know when a listing is complete.
- [Registration](https://felix.trade/docs/api/registration): Register an owner address with a locally signed challenge and receive the account's first API key.
- [Accounts](https://felix.trade/docs/api/accounts): Create, list, and archive isolated child accounts under a manage key.
- [Keys](https://felix.trade/docs/api/keys): List and revoke API keys, and mint owner-signed live keys with per-order, daily-notional, and daily-loss caps.
- [Markets](https://felix.trade/docs/api/markets): Discover instruments, read quotes, order books, funding, and option chains, and call the bounded research endpoints that never place an order.
- [Orders](https://felix.trade/docs/api/orders): Preview and place real-money orders, batch them, inspect an ambiguous intent, cancel resting orders, and trigger the emergency stop.
- [Positions and exit plans](https://felix.trade/docs/api/positions): Read open positions, close them, poll asynchronous closes, and manage server-monitored exit plans.
- [Reporting](https://felix.trade/docs/api/reporting): Balances, the money map, deposit address, portfolio, fills, PnL, and insights, all scoped to the key's account and honest about unavailable sources.
- [Wallet](https://felix.trade/docs/api/wallet): Deploy the owner-controlled policy wallet, migrate a legacy wallet, sign policy actions, and verify custody against chain state.
- [Funding](https://felix.trade/docs/api/funding): Move money between the owner wallet and venues with prepare, client-execute, confirm workflows, settle network fees, top up execution-fee credit, and use the compatibility routes.
- [Venue onboarding](https://felix.trade/docs/api/venue-onboarding): Enable each venue for an account with owner-signed sessions, scoped API wallets, deposit wallets, exchange approvals, and the autonomous prediction-market wallet.
- [Prediction-market orders](https://felix.trade/docs/api/prediction-market-orders): The client-signed order flow for prediction markets: prepare, checkpoint, submit, commit, reconcile, close, and redeem.
- [Withdrawals](https://felix.trade/docs/api/withdrawals): Authorize withdrawal destinations with owner signatures and withdraw with a locally signed transaction.
- [Strategies](https://felix.trade/docs/api/strategies): Read the strategy sandbox contract and, optionally, generate a strategy from a plain-language idea.
- [Backtests](https://felix.trade/docs/api/backtests): Run a read-only backtest synchronously or as a durable operation, poll it, and resume it after an expired lease.
- [Agents](https://felix.trade/docs/api/agents): Deploy, list, inspect, update, and stop agents, read their decision logs, take the one-call situation snapshot, and long-poll account events.
- [Mandates](https://felix.trade/docs/api/mandates): Bind one live key to owner-signed venues, instruments, size, concentration, slippage, leverage, and expiry for unattended trading.
- [Portfolio risk](https://felix.trade/docs/api/portfolio-risk): Set an account-wide risk mandate, read a combined-book risk snapshot, and preview position sizes, orders, and rebalances against it.
- [Routing](https://felix.trade/docs/api/routing): Cross-venue request-for-quote routing and the fast funding routes, which are discoverable now and execute only when capabilities report readiness.
- [Streams](https://felix.trade/docs/api/streams): Mint the one-time ticket that authenticates a read-only market-data WebSocket session.
- [Webhooks](https://felix.trade/docs/api/webhooks): Register, list, test, and delete signed HTTPS webhooks for fill, position, and agent events.
- [Plans and subscription](https://felix.trade/docs/api/plans): Read the public tiers, inspect the calling account's plan and limits, pay for 30 days of Pro with an owner-signed transfer, and create referral codes.
- [Feedback and support](https://felix.trade/docs/api/feedback-and-support): Report feedback and run encrypted, account-scoped support tickets through the API.
- [Platform](https://felix.trade/docs/api/platform): Health, readiness, runtime status, client-observable reliability fields, the fee schedule, and the live capability matrix.

## MCP reference

- [MCP overview](https://felix.trade/docs/mcp/overview): What the felix-mcp server is, how it holds credentials, how sessions bind to accounts, and how to read the tool catalog.
- [MCP tools](https://felix.trade/docs/mcp/tools): Every tool in the published felix-mcp package, grouped by task, with its arguments and the ones that are required.
- [MCP resources](https://felix.trade/docs/mcp/resources): The documentation resources bundled with felix-mcp, readable without an API key, and the order in which an agent should read them.
- [felix-keys command](https://felix.trade/docs/mcp/felix-keys): The local custody command shipped with felix-mcp: guided onboarding, identity status, and owner-controlled backup, verification, and recovery.

## SDKs

- [SDK overview](https://felix.trade/docs/sdks/overview): The Python and TypeScript clients, what they add on top of the REST contract, and how they are distributed.
- [Python SDK](https://felix.trade/docs/sdks/python): Install the felixtrade source artifact and use it for quotes, orders, market data streams, backtests, client-signed prediction-market orders, and live keys.
- [TypeScript SDK](https://felix.trade/docs/sdks/typescript): Install the felix-sdk source artifact and use it for quotes, orders, backtests, client-signed prediction-market orders, and live keys.

## Resources

- [Glossary](https://felix.trade/docs/resources/glossary): The terms this documentation uses for identities, authority, money, orders, and automation, each with one precise meaning.
- [Capability boundaries](https://felix.trade/docs/resources/capability-boundaries): What Felix does not offer as a first-class capability today, stated explicitly so agents plan around it instead of inferring or fabricating it.

## Optional

- [Complete documentation as one file](https://felix.trade/llms-full.txt): every page above, rendered as Markdown.
- [Machine-readable agent index](https://felix.trade/agent-index.json): documentation order, workflows, and capability boundaries.
- [Runtime status](https://api.felix.trade/v1/status): service health, API version, and minimum MCP version.
- [Human-readable status](https://felix.trade/status) and [changelog](https://felix.trade/changelog).
- [Article feed](https://felix.trade/feed.xml) and [sitemap](https://felix.trade/sitemap.xml): the public article feed and the canonical URL index.