# FoxD

> Multi-chain trading platform indexing Solana, Ethereum, BNB Chain, Base, Arbitrum and
> HyperEVM from raw on-chain data. Token discovery, safety analysis, wallet intelligence,
> trading and multi-launchpad token launching — available to agents over MCP, REST, an SDK
> and a CLI.

## Connect

- [MCP endpoint](https://foxd.xyz/api/mcp): streamable HTTP. 86 tools, 5 resources, 5 prompts.
- [REST API](https://foxd.xyz/api/v1): self-describing index of every tool and route.
- [OpenAPI 3.1](https://foxd.xyz/api/v1/openapi.json): generated from the same contract.
- [Docs](https://foxd.xyz/docs): full documentation.

## Install

```
npx foxd-mcp --claude      # or --cursor, --codex, --opencode, --vscode, --openclaw
npm i foxd-sdk             # typed TypeScript client
npm i -g foxd-cli && foxd  # command line
```

## Authentication

EVERY tool requires an API key. Keys are free during early access. Two ways to get one:

- Headless: `auth.challenge` → sign the message → `auth.verifyWallet`. No browser, no human.
- With a human: `auth.startDeviceLogin` → they approve in a browser → `auth.pollDeviceLogin`.
  Covers Google, X, Telegram, email and wallet sign-in.

Every route reaches the same account as the web terminal.

## Tools

### auth (5)

- **auth.challenge** — Get a wallet sign-in challenge. _public_
- **auth.verifyWallet** — Sign in with a wallet signature. _public_
- **auth.startDeviceLogin** — Start a browser sign-in from a headless client. _public_
- **auth.pollDeviceLogin** — Poll for device sign-in completion. _public_
- **auth.verifyTelegram** — Sign in with Telegram Mini App data. _public_

### market (13)

- **market.chains** — List supported chains. _read_
- **market.platforms** — List DEXes and launchpads. _read_
- **market.trending** — Trending tokens. _read_
- **market.newTokens** — Newest tokens. _read_
- **market.search** — Search tokens. _read_
- **market.resolve** — Resolve an address to its chain. _read_
- **market.token** — Token detail. _read_
- **market.swaps** — Recent swaps for a token. _read_
- **market.candles** — OHLCV candles. _read_
- **market.holders** — Top holders and concentration. _read_
- **market.sparklines** — Batch price series. _read_
- **market.live** — Live consolidated market data. _read_
- **market.tokenMeta** — Batch token identity. _read_

### analytics (5)

- **analytics.security** — Token safety facts. _read_
- **analytics.simulateHoneypot** — Simulate a buy and sell. _read_
- **analytics.token** — Quantitative token analysis. _read_
- **analytics.curvePrice** — Curve-derived price. _read_
- **analytics.score** — FoxScore breakdown. _read_

### sniper (4)

- **sniper.feed** — Fresh launch feed. _read_
- **sniper.graduating** — Tokens near graduation. _read_
- **sniper.bondingProgress** — Bonding curve progress. _read_
- **sniper.platforms** — Launchpad activity. _read_

### copyIntel (5)

- **copyIntel.leaderboard** — Top trader leaderboard. _read_
- **copyIntel.categories** — Trader category counts. _read_
- **copyIntel.trader** — Wallet analytics. _read_
- **copyIntel.traderTrades** — Wallet trade tape. _read_
- **copyIntel.backtest** — Backtest copying a wallet. _read_

### copyExec (4)

- **copyExec.subscriptions** — List copy subscriptions. _copy:read_
- **copyExec.subscribe** — Start copying a wallet. _copy:write_
- **copyExec.updateSubscription** — Update a copy subscription. _copy:write_
- **copyExec.unsubscribe** — Stop copying a wallet. _copy:write_

### trade (6)

- **trade.chains** — Chains where trading is live. _read_
- **trade.mevProtection** — MEV protection readiness. _read_
- **trade.quote** — Quote a trade. _trade:read_
- **trade.execute** — Execute a trade. _trade:execute_
- **trade.venues** — Venue coverage. _read_
- **trade.feePreview** — Fees and tips for a trade size. _trade:read_

### wallet (13)

- **wallet.balances** — Native balances across every chain. _wallet:read_
- **wallet.portfolio** — Full portfolio with USD values. _wallet:read_
- **wallet.list** — List wallets. _wallet:read_
- **wallet.activity** — Wallet activity feed. _wallet:read_
- **wallet.trades** — Trade journal and realised PnL. _wallet:read_
- **wallet.gasEstimate** — Gas hold-back for a max send. _wallet:read_
- **wallet.send** — Send native coin. _wallet:write_
- **wallet.reclaimRent** — Reclaim Solana rent. _wallet:write_
- **wallet.create** — Create a wallet. _wallet:write_
- **wallet.update** — Rename a wallet or set it default. _wallet:write_
- **wallet.delete** — Delete a wallet. _wallet:write_
- **wallet.import** — Import an existing private key. _wallet:write_
- **wallet.export** — Reveal a wallet's private key. _wallet:write_

### launch (8)

- **launch.pads** — Launchpad catalogue. _read_
- **launch.quote** — Quote a multi-pad launch. _launch:read_
- **launch.create** — Launch a token across several launchpads. _launch:write_
- **launch.variants** — Variants of a launch. _read_
- **launch.studio** — Your launches and claimable fees. _launch:read_
- **launch.claimFees** — Claim creator fees. _launch:write_
- **launch.explore** — Browse all multiverse launches. _read_
- **launch.migrate** — Move a position between variants. _trade:execute_

### automation (11)

- **automation.orders** — List active orders. _automation:read_
- **automation.placeLimit** — Place a limit order. _automation:write_
- **automation.placeTakeProfit** — Place a take-profit. _automation:write_
- **automation.placeStopLoss** — Place a stop-loss. _automation:write_
- **automation.placeTrailingStop** — Place a trailing stop. _automation:write_
- **automation.placeDca** — Place a DCA schedule. _automation:write_
- **automation.cancelOrder** — Cancel an order. _automation:write_
- **automation.strategies** — List strategies. _automation:read_
- **automation.createStrategy** — Create a strategy. _automation:write_
- **automation.updateStrategy** — Update or activate a strategy. _automation:write_
- **automation.deleteStrategy** — Delete a strategy. _automation:write_

### alerts (3)

- **alerts.list** — List webhooks. _read:account_
- **alerts.subscribe** — Register a webhook. _read:account_
- **alerts.unsubscribe** — Delete a webhook. _read:account_

### account (5)

- **account.whoami** — Identity behind this key. _read:account_
- **account.wallets** — List custodial wallets. _wallet:read_
- **account.usage** — This key's usage and quota. _read:account_
- **account.preferences** — Read account preferences. _read:account_
- **account.updatePreferences** — Update account preferences. _read:account_

### keys (4)

- **keys.list** — List API keys. _keys:manage_
- **keys.create** — Issue a new API key. _keys:manage_
- **keys.revoke** — Revoke an API key. _keys:manage_
- **keys.setStatus** — Pause or resume a key. _keys:manage_

## Notes for agents

- Price changes are RATIOS, not percents: `0.05` means +5%.
- Check safety with BOTH `analytics.security` and `analytics.simulateHoneypot` before any buy.
  `simulated: false` is not a pass — it means no conclusion was reached.
- `market.holders` reports top-10 share of FREE FLOAT, not of total supply.
- Everything is free during early access; quotas are enforced and 429s carry `Retry-After`.