Skip to main content
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.
The SURCHI Developer API launches in Phase 2. Join the early access waitlist at surchi.io/developers to be notified when access opens and to receive SDK previews and API documentation updates ahead of the public launch.

​
What You Can Build

Trading Bots

Consume real-time AI signals from Alpha Sentinel to power automated trading strategies with confidence-scored, on-chain-verified intelligence.

Portfolio Analytics Dashboards

Query wallet portfolio data and market analytics to build rich, data-driven dashboards for individual wallets or aggregate DeFi positions.

Custom Alert Systems

Subscribe to live signal streams and trigger custom notifications — Telegram bots, email alerts, or webhook-based pipelines — when conditions are met.

DeFi Strategy Automation

Submit natural language or structured strategies to the Execution Sentinel to automate on-chain actions within user-defined risk parameters.

Wallet Intelligence Features

Enrich your app with wallet-level intelligence: token holdings, PnL analytics, whale detection, and transaction history across Solana DEXes.

Cross-Protocol Aggregators

Aggregate liquidity, price, and sentiment data from multiple Solana protocols into unified intelligence feeds for research or trading infrastructure.

​
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 guide to get started.

​
Explore the API

Authentication

Obtain a Bearer token and authenticate your requests.

Intelligence API

Fetch AI signals and subscribe to live signal streams.

Market Data API

Query real-time and historical on-chain market data.

Wallet Integration

Connect Solana wallets and query portfolio analytics.

Rate Limits

Understand quotas, tiers, and how to handle 429 errors.

SDKs

Official and community client libraries for JS, TS, and Python.