API Reference

Base URL

/api

All responses are returned in JSON format.

---

Market Data API

Get Markets

GET /api/markets

Returns a normalized list of supported market data.

Response

[
  {
    "symbol": "SOL",
    "price": 98.42,
    "change24h": 3.21,
    "volume": 124500000
  }
]

Notes

• Data is refreshed periodically at the backend

• Used by both Trading Terminal and AI Signal Engine

• Acts as authoritative price input for signal generation

---

Trading API

Execute Swap

POST /api/trade/swap

Executes a token swap via on-chain liquidity routing.

Request Body

{
  "inputMint": "So11111111111111111111111111111111111111112",
  "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amount": 100,
  "slippage": 0.5,
  "walletAddress": "UserPublicKey"
}

Response

{
  "success": true,
  "txSignature": "5hFJ...xQe",
  "inputAmount": 100,
  "outputAmount": 1.02
}

Notes

• Transaction is signed client-side

• Backend only constructs and routes the transaction

• No custody or off-chain settlement

---

Trade History

GET /api/trade/history/:walletAddress

Returns historical trade execution data for a wallet.

Response

[
  {
    "txSignature": "5hFJ...xQe",
    "inputToken": "USDC",
    "outputToken": "SOL",
    "amount": 100,
    "timestamp": "2026-01-02T12:00:00Z"
  }
]

---

Wallet API

Get Wallet Balance

GET /api/wallet/balance/:walletAddress

Returns current on-chain balances for supported assets.

Response

{
  "sol": 2.43,
  "usdc": 512.78
}

Notes

• Balances are fetched directly from on-chain data sources

• No internal accounting or shadow balances

---

AI Signals API

Get AI Signals

GET /api/signals/futures

Returns the latest AI-generated trading signals.

Response

[
  {
    "signalId": "SOL-LONG-001",
    "symbol": "SOL",
    "direction": "long",
    "entry": 95.2,
    "tp": [97.5, 99.8, 103.0],
    "stopLoss": 92.1,
    "confidence": 78,
    "riskReward": 2.6,
    "reasoning": "Momentum continuation with volume confirmation"
  }
]

---

Get Tracked Positions

GET /api/signals/positions

Returns all tracked positions and their current state.

Response

[
  {
    "symbol": "SOL",
    "direction": "long",
    "entryPrice": 95.2,
    "currentPrice": 98.4,
    "status": "open",
    "pnlPercent": 3.36
  }
]

---

Position Statistics

GET /api/signals/positions/stats

Returns aggregated performance metrics.

Response

{
  "total": 42,
  "wins": 26,
  "losses": 12,
  "pending": 4,
  "winRate": 61.9,
  "totalPnl": 18.4
}

---

Update Position Prices

POST /api/signals/positions/update-prices

Triggers a backend price refresh and position evaluation.

Notes

• Used by scheduled jobs and monitoring services

• Handles TP/SL checks and state transitions

---

API Design Principles

Zoryu’s APIs follow several core design principles:

• Non-Custodial APIs never handle private keys or signing logic.

• Execution-Aware Endpoints are built around real execution and position state, not simulated flows.

• Deterministic Responses Outputs are structured for programmatic use, not manual interpretation.

• Backend as Authority Frontend consumes state, never defines it.