Skip to main content
The Syra API provides programmatic access to trading signals, research, news, sentiment, and on-chain data. Use it to build custom trading bots, analytics dashboards, or integrate AI intelligence into your applications.

API Endpoint

The production API is available at:
https://api.syraa.fun

Authentication & Payment

The Syra API uses x402 for pay-per-request access. Most endpoints require payment via Solana.

Payment Methods

  • x402 Payment Headers — Include payment signature in request headers
  • Solana Wallet — Pay directly from your wallet
  • API Playground — Use the playground for wallet-based payments
Endpoints return 402 Payment Required without a valid payment header. Use the API Playground to handle payments automatically.

Quick Start with API Playground

The easiest way to explore the API:
1

Visit API Playground

2

Connect Wallet

Connect your Solana wallet (Phantom, Solflare, etc.)
3

Select an Endpoint

Choose from:
  • News & Events
  • Trading Signals
  • Research & Browse
  • Token Data (Rugcheck, Nansen, Bubblemaps)
  • Analytics Summary
  • Memecoin Screens
4

Send Request

Click “Send” — the playground handles x402 payment automatically

Core Endpoints

News & Events

GET /news?ticker=BTC
GET /event?ticker=general
Get latest crypto news and upcoming events.

Trading Signals

GET /signal?token=bitcoin
AI-generated trading signals with entry/exit recommendations.

Sentiment & Headlines

GET /sentiment?ticker=ETH
GET /trending-headline?ticker=general
Market sentiment (30-day) and trending headlines.

Research & Browse

GET /research?query=solana%20defi&type=deep
GET /browse?query=https://example.com
GET /x-search?query=bitcoin%20sentiment
AI-powered deep research, web browsing, and X/Twitter search.

Token Data

GET /token-report?address=<solana_address>
GET /token-statistic
GET /token-risk/alerts?rugScoreMin=80
Rugcheck reports, token statistics, and risk alerts.

Analytics

GET /analytics/summary
GET /smart-money
GET /dexscreener
GET /trending-jupiter
Full analytics including smart money, DEXScreener, and Jupiter trending.

Memecoin Screens

GET /memecoin/fastest-holder-growth
GET /memecoin/most-mentioned-by-smart-money-x
GET /memecoin/strong-narrative-low-market-cap
Screens for memecoins with specific characteristics.

Local Development

For testing without payment, run the API locally:
1

Clone the Repository

git clone <syra-monorepo-url>
cd syra-monorepo/api
2

Install Dependencies

npm install
3

Configure Environment

Set required environment variables:
# Solana RPC endpoint
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# MongoDB connection (if needed)
MONGODB_URI=mongodb://localhost:27017/syra

# Other API keys as needed
4

Start the Server

npm run dev
API runs on http://localhost:3000 by default.

Dev Routes (No Payment)

When running locally, use /dev routes to bypass x402 payment:
GET /news/dev?ticker=BTC
GET /signal/dev?token=bitcoin
Dev routes are only available when NODE_ENV !== "production". Do not use in production.

Integration Example

Node.js / JavaScript

const response = await fetch('https://api.syraa.fun/news?ticker=BTC', {
  headers: {
    'X-Payment': '<x402-payment-signature>'
  }
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
    'https://api.syraa.fun/signal',
    params={'token': 'bitcoin'},
    headers={'X-Payment': '<x402-payment-signature>'}
)

data = response.json()
print(data)

cURL

curl -H "X-Payment: <x402-payment-signature>" \
  "https://api.syraa.fun/analytics/summary"

Response Format

All endpoints return JSON. Successful responses (200 OK) include:
{
  "data": { ... },
  "timestamp": "2026-03-03T12:00:00Z",
  "status": "success"
}
Error responses include:
{
  "error": "Error message",
  "status": 402,
  "payment": {
    "required": true,
    "amount": "0.001",
    "currency": "SOL"
  }
}

Rate Limits

Rate limits apply based on endpoint and payment tier. The API returns 429 Too Many Requests when limits are exceeded.
Use the MCP Server to access the API from AI assistants like Cursor and Claude Desktop without writing integration code.

Next Steps

  • Explore all endpoints in the API Playground
  • Set up the MCP Server for AI assistant integration
  • Review the full API reference documentation
  • Join the community on X (Twitter) for updates

Build docs developers (and LLMs) love