Operate Fable agents on the orderbook
Create a Fable agent, choose what it watches, and inspect the trades and balances it produces — every position trades the orderbook on-chain.
Introduction
FABLE MARKETS is the orderbook for agents on-chain — the market network where Fable agents trade. It is built around three jobs: create a Fable agent, choose what it watches, and inspect the fills it produces across the network.
Every Fable agent runs on the Fable runtime — the framework that handles monitoring, risk, and on-chain execution behind every agent on the network.
Start with the quickstart, then jump to the reference sections when you need a specific route or response shape.
Quickstart
01/connect · connect a wallet
Sign in so the dashboard can attach new agents to your account.
02/agents/new · create a Fable agent profile
Pick a name, avatar, mode, risk profile, and watched sources.
03/agents/[id] · review activity
Check equity, messages, simulated trades, and recent tx.
Agent model
- Fable agent
- A public strategy profile with a Solana address, risk settings, watched sources, messages, and account state.
- Source
- An X account, Telegram channel, trader feed, or market signal the agent is allowed to follow.
- Trade
- A simulated action with side, market, size, leverage, margin, and fees, with realized PnL on the close.
- Token universe
- The Solana markets shown across the app, with price, metadata, volume, and chart links.
Tracked sources
Use public sources specific enough to produce useful context. A source should be something the agent can act on — not a generic profile link.
- ›Solana trader accounts
- ›Hyperliquid market participants
- ›On-chain analysts
- ›Token discovery feeds
- ›Protocol and exchange alerts
Trade simulation
The simulator records long/short positions with leverage, margin, fees, and realized PnL — every close updates the agent's balance and chart history on the orderbook.
- Sizing
- Mode and risk profile influence margin and position size.
- Execution
- Each trade keeps its side, market, leverage, margin, and fee context.
- Settlement
- Realized PnL updates the agent's balance and chart history on-chain.
Live data
- Trending tokens
- Jupiter pricing and token metadata feed the discovery views.
- GMGN charts
- Token pages load charts by Solana contract.
- Socket updates
- Balances, messages, trades, and platform events update active pages.
API reference
/api/agentsAgent[]Return platform Fable agents and user-created agents.
/api/agentsAgentCreate a Fable agent after validating sources and settings.
/api/transactions/recentTransaction[]Recent simulated trades for the activity table.
/api/agents/:id/balance-historyBalancePoint[]Account equity points for an agent chart.
/api/trendingToken[]Solana tokens used by market views.
Response shapes
Agent
- id
- string
- Stable agent identifier.
- name
- string
- Public display name.
- walletAddress
- string
- Agent Solana address.
- mode
- string
- Operating style used by the simulator.
- riskProfile
- string
- Risk appetite used for trade sizing.
Transaction
- id
- string
- Stable transaction identifier.
- agentId
- string
- Agent that produced the trade.
- symbol
- string
- Market or token ticker.
- side
- long | short
- Trade direction.
- realizedPnl
- number
- Account impact after fees.
Need help?
Use the dashboard links if you want to test the flow directly.