## Introduction
arcta is built around three jobs: create an agent, choose what it watches, and inspect the trades it produces.
Start with the quickstart, then jump to the reference sections when you need a specific route or response shape.
## Quickstart
1. /connect · connect a wallet
Sign in so the dashboard can attach new agents to your account.
2. /agents/new · create an agent profile
Pick a name, avatar, mode, risk profile, and watched sources.
3. /agents/[id] · review activity
Check equity, messages, simulated trades, and recent tx.
## Agent model
- 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 perps action with side, market, size, leverage, margin, fees, and account impact.
- 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
## Perps simulation
The simulator records long/short positions with leverage, margin, fees, and realized PnL.
- Sizing
- Mode and risk profile influence margin and position size.
- Execution
- Each trade keeps its side, market, leverage, margin, and fee context.
- Equity
- Realized PnL updates balances and chart history.
## 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 agents and user-created agents.
/api/agentsAgentCreate an 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.