# Documentation

fractrade is a free research project with one goal: to build **the best data and tools for
AI trading and agentic trading**, starting with Hyperliquid. This is version 2 of it.

It has two parts. Each one connects to your AI agent as an
[MCP](https://modelcontextprotocol.io) server.

| | What it does | Where it runs | What it needs |
|---|---|---|---|
| **fractrade** | Market intelligence: prices, trends, funding, the cost of a trade, detections, and what wallets do and hold | Hosted by us at `api.fractrade.xyz` | An API key, which a wallet that holds 10,000 FRAC makes in the app |
| **fractrade-hl-simple** | Reads your Hyperliquid account and, once you switch trading on, places, changes and cancels orders | On your own computer | Your Hyperliquid account, an API wallet for trading, and Claude or an open-weight model |

Your agent asks fractrade what it needs to know, decides, and trades through
fractrade-hl-simple. You stay in control: the fractrade key cannot trade or move anything, and
trading runs on your machine within limits you set.

## Pages

- **[Trade with your AI agent](/docs/agent-trading/)**: connect both servers to your agent in
  five steps.
- **[API](/docs/api/)**: the same data over plain HTTP, with keys, limits and errors.
- **[FAQ](/docs/faq/)**: what it costs, which agents work, and who holds what.

## Which agents work

- **For the data:** any MCP client, such as Claude Code, Claude Desktop or Codex CLI.
- **For trading:** Claude, in Claude Code or Claude Desktop. Codex usually refuses to place
  live orders. Open-weight models work too, through any MCP client that runs them.

## Addresses

| Address | What it is |
|---|---|
| `https://app.fractrade.xyz` | The app. You open it in a browser and sign in with your wallet |
| `https://api.fractrade.xyz` | The API, for programs and agents. It describes itself at this address |
| `https://api.fractrade.xyz/mcp` | The fractrade MCP server |

## Access

fractrade is free: there is no subscription and no fee.

**In the app, for everyone, up to 15 minutes old:** markets, candles, trends, funding, the
cost of a trade, stocks and commodities, market-wide figures, scheduled dates, detections,
wallets, the leaderboard and news. No sign-up is needed to look.

**For wallets that hold 10,000 FRAC:** all of it live, and everything else, which is wallet
analysis and history, the trades of the day, whale orders, fresh wallets with one large bet,
liquidations and transfers of the wallets we analyse, positioning and tiers, which shorts are
hedges, every move of twenty tracked wallets, what a wallet holds and which orders it has
resting right now, and a watchlist of your own. Also one API key.

**The API and the MCP server answer only with a key.** A program or an agent needs the key of
an account that holds 10,000 FRAC for every request.

- **What counts:** FRAC in the wallet's spot balance on Hyperliquid, including what is in
  open orders. FRAC that is staked, lent, in a pool or on another exchange is not seen.
- **How it is checked:** the balance is read when you sign in and again once a day.
- **Signing in** is a signature of a short text, not a transaction. It costs nothing and moves
  nothing, and the FRAC stays in your wallet.

FRAC is a spot token on Hyperliquid. We did not launch it and do not control it. The
[FRAC page](/token/) says what holding it does and does not do, who holds it, and how to get
it.

## What each key can and cannot do

| | Can | Cannot |
|---|---|---|
| The wallet that holds FRAC | Prove it is yours by a signature | Be charged, moved or traded by signing in |
| The fractrade API key | Read market intelligence as your account | Trade, withdraw, or see your trading account |
| The API wallet of fractrade-hl-simple | Trade the account it was authorized for, within your limits | Withdraw funds |

## What we do and do not do

- **We publish data.** What it means and what to do with it is yours to decide.
- **We hold no user keys or funds.**
- **Nothing here is investment advice.** You and your agent decide. Trading perpetual futures
  carries a high risk of loss.

## For agents

Every page of this documentation is also served as Markdown:
[`/docs/index.md`](/docs/index.md), [`/docs/agent-trading.md`](/docs/agent-trading.md),
[`/docs/api.md`](/docs/api.md) and [`/docs/faq.md`](/docs/faq.md). An index for language
models is at [`/llms.txt`](/llms.txt).

## Contact

News and updates: [@fractrade_xyz](https://x.com/fractrade_xyz) on X. Questions: our
[Telegram group](https://t.me/+GLWYcyXi1dtmYzhk). Code:
[github.com/fractrade-xyz](https://github.com/fractrade-xyz).
