> ## Documentation Index
> Fetch the complete documentation index at: https://ducs.surchi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# SURCHI Developer API: Build on AI DeFi Intelligence

> Programmatic access to SURCHI AI market signals, on-chain Solana data, and execution capabilities. Developer API Alpha launches in Phase 2.

The SURCHI Developer API is the infrastructure layer for builders who want to integrate AI-powered Web3 intelligence directly into their applications. Whether you're building a trading bot, a portfolio analytics dashboard, or a DeFi automation tool, the API gives you programmatic access to the same Alpha Sentinel signals, on-chain market data, and Execution Sentinel capabilities that power the SURCHI protocol — all through a clean, RESTful interface with WebSocket support for real-time feeds.

<Note>
  The SURCHI Developer API launches in Phase 2. Join the early access waitlist at [surchi.io/developers](https://surchi.io/developers) to be notified when access opens and to receive SDK previews and API documentation updates ahead of the public launch.
</Note>

## What You Can Build

<CardGroup cols={2}>
  <Card title="Trading Bots" icon="robot">
    Consume real-time AI signals from Alpha Sentinel to power automated trading strategies with confidence-scored, on-chain-verified intelligence.
  </Card>

  <Card title="Portfolio Analytics Dashboards" icon="chart-line">
    Query wallet portfolio data and market analytics to build rich, data-driven dashboards for individual wallets or aggregate DeFi positions.
  </Card>

  <Card title="Custom Alert Systems" icon="bell">
    Subscribe to live signal streams and trigger custom notifications — Telegram bots, email alerts, or webhook-based pipelines — when conditions are met.
  </Card>

  <Card title="DeFi Strategy Automation" icon="gears">
    Submit natural language or structured strategies to the Execution Sentinel to automate on-chain actions within user-defined risk parameters.
  </Card>

  <Card title="Wallet Intelligence Features" icon="wallet">
    Enrich your app with wallet-level intelligence: token holdings, PnL analytics, whale detection, and transaction history across Solana DEXes.
  </Card>

  <Card title="Cross-Protocol Aggregators" icon="arrows-split-up-and-left">
    Aggregate liquidity, price, and sentiment data from multiple Solana protocols into unified intelligence feeds for research or trading infrastructure.
  </Card>
</CardGroup>

## API Capabilities

The SURCHI Developer API exposes the following core capabilities:

* **Real-time market intelligence signals** generated by Alpha Sentinel — confidence-scored, directional signals with on-chain trigger attribution
* **On-chain market data** aggregated in real time across Solana DEXes including Raydium, Orca, and Meteora — prices, volume, liquidity, and TVL
* **Natural language strategy submission** to Execution Sentinel — define strategies in plain English or structured JSON and let the AI translate them into on-chain actions
* **Wallet portfolio analytics** — query any Solana wallet for token balances, historical PnL, and asset composition
* **WebSocket streaming** — subscribe to a persistent live feed of intelligence signals with asset and confidence filters

## Base URL

All API requests are made to the following base URL:

```
https://api.surchi.io/v1
```

All endpoints return JSON. All requests must be authenticated with a Bearer token. See the [Authentication](/developers/authentication) guide to get started.

## Explore the API

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/developers/authentication">
    Obtain a Bearer token and authenticate your requests.
  </Card>

  <Card title="Intelligence API" icon="brain" href="/developers/ai-intelligence-api">
    Fetch AI signals and subscribe to live signal streams.
  </Card>

  <Card title="Market Data API" icon="chart-bar" href="/developers/market-data-api">
    Query real-time and historical on-chain market data.
  </Card>

  <Card title="Wallet Integration" icon="wallet" href="/developers/wallet-integration">
    Connect Solana wallets and query portfolio analytics.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/developers/rate-limits">
    Understand quotas, tiers, and how to handle 429 errors.
  </Card>

  <Card title="SDKs" icon="code" href="/developers/sdks">
    Official and community client libraries for JS, TS, and Python.
  </Card>
</CardGroup>