API Playground

Overview

The Syra API Playground is an interactive web interface for testing and exploring the Syra API. Connect your Solana wallet, build requests, handle x402 payments, and inspect responses—all from your browser. Playground URL: https://playground.syraa.fun

Features

Interactive Request Builder — Select endpoints, configure parameters, and send requests
x402 Payment Handling — Connect Solana wallet for pay-per-request flows
Response Inspector — View JSON responses with syntax highlighting
Request History — Track your API calls and responses
Quick Examples — Pre-configured requests for common use cases
Authentication Testing — Test both paid and dev/free endpoints

Supported Endpoints

The playground provides access to all Syra API endpoints:

Trading & Signals

Signals — AI-generated trading analysis (/signal)
Analytics Summary — Full analytics overview (/analytics/summary)

Market Data

News — Latest crypto news by ticker (/news)
Events — Upcoming crypto events (/event)
Sentiment — Market sentiment analysis (/sentiment)
Trending Headlines — Hot crypto topics (/trending-headline)

Research

Deep Research — AI-powered research (/research)
Web Browse — Extract info from URLs (/browse)
X Search — Twitter/X trend analysis (/x-search)
EXA Search — AI web search (/exa-search)

Token Analysis

Token Report — Rugcheck analysis (/token-report)
Token Risk Alerts — High-risk token scanner (/token-risk/alerts)
Token God Mode — Nansen deep research (/token-god-mode)
Token Statistics — Rugcheck stats (/token-statistic)

On-chain & DeFi

Smart Money — Wallet tracking (/smart-money)
DEXScreener — DEX data (/dexscreener)
Jupiter Trending — Trending on Jupiter (/trending-jupiter)
Bubblemaps — Holder maps (/bubblemaps/maps)

Memecoin Screens

Fastest Holder Growth — Growth rate analysis
Smart Money Mentions — KOL tracking
Pre-CEX Accumulation — Early accumulation signals
Strong Narrative + Low Mcap — Narrative analysis
Experienced Devs — Developer reputation
Whale Behavior — Unusual whale activity
Trending on X not DEX — Social vs. trading volume
Organic Traction — Grassroots growth
Surviving Dumps — Resilience metrics

Binance Data

Correlation — Asset correlation (/binance/correlation)
Correlation Matrix — Full matrix (/binance/correlation-matrix)

Utilities

Health Check — API status (/check-status)
Sundown Digest — Daily roundup (/sundown-digest)
Crypto KOL — Influencer insights (/crypto-kol)
Hidden Gems — Emerging projects (/gems)

Quick Start

Open the Playground

Navigate to playground.syraa.fun

Connect Wallet (Optional)

For endpoints requiring x402 payment:

Click Connect Wallet
Select your Solana wallet (Phantom, Solflare, etc.)
Approve the connection

Free/dev endpoints don’t require wallet connection during development.

Build Your Request

Use the Request Builder:

Select an endpoint from the dropdown
Configure parameters (ticker, token, address, etc.)
Review the generated request

Send Request

Click Send Request:

Free endpoints: Returns data immediately
Paid endpoints: Prompts for x402 payment, then returns data

Inspect Response

View the response in the inspector:

JSON syntax highlighting
Status code and headers
Response time metrics

x402 Payment Flow

For endpoints gated by x402 payment:

Request Initiated

You send a request to a paid endpoint (e.g., /token-report)

Payment Required

API returns 402 Payment Required with payment details:

{
  "statusCode": 402,
  "message": "Payment Required",
  "paymentDetails": {
    "amount": "0.001",
    "currency": "SOL",
    "recipient": "<wallet_address>"
  }
}

Wallet Confirmation

The playground prompts you to approve the payment in your wallet

Payment Sent

Transaction is broadcast to Solana blockchain

Verification

API verifies payment signature and on-chain transaction

Data Delivered

API returns requested data with 200 OK status

Request Builder

Endpoint Selection

Choose from categorized endpoints:

Quick Select — Common operations
Full List — All available endpoints
Examples — Pre-configured use cases

Parameter Configuration

News
Signal
Research
Token Report
Token Risk Alerts

GET /news?ticker=BTC

Parameters:

ticker (optional): BTC, ETH, SOL, or general (default)

GET /signal?token=bitcoin

Parameters:

token (optional): Token name (default: bitcoin)

GET /research?query=Solana+DeFi+trends&type=deep

Parameters:

query (required): Research topic
type (optional): quick or deep

GET /token-report?address=<solana_address>

Parameters:

address (required): Solana token contract address

GET /token-risk/alerts?rugScoreMin=80&limit=20

Parameters:

rugScoreMin (optional): Minimum risk score (default: 80)
source (optional): Data source
limit (optional): Results limit (default: 20)

Response Inspector

The response viewer provides:

JSON Formatting

{
  "status": "success",
  "data": {
    "token": "bitcoin",
    "signal": {
      "price": 67500,
      "trend": "bullish",
      "confidence": 0.85
    }
  },
  "timestamp": "2026-03-03T12:00:00Z"
}

Response Metadata

Status Code: HTTP status (200, 402, 404, etc.)
Response Time: Request duration in ms
Content Type: Response format
Headers: Full response headers

Error Handling

Common Errors:

402 Payment Required — Connect wallet and approve payment
400 Bad Request — Check parameter format
404 Not Found — Verify endpoint URL
500 Server Error — API service issue (check status)

Request History

Track all your API calls:

Timestamp — When the request was made
Endpoint — Which API route was called
Parameters — Request configuration
Status — Success/failure indicator
Payment — Whether x402 payment was required

History Actions

Replay — Re-send the same request
Edit — Modify parameters and resend
Export — Save request/response as JSON
Clear — Remove history entries

Example Workflows

1. Token Due Diligence

Get Token Report

GET /token-report?address=<token_address>

Review Rugcheck analysis and risk score.

Check Holder Distribution

GET /bubblemaps/maps?address=<token_address>

Analyze holder concentration.

Research Social Sentiment

GET /x-kol?address=<token_address>

See what KOLs are saying.

Get Trading Signal

GET /signal?token=<token_name>

AI-generated entry/exit recommendations.

2. Market Overview

Check Market Sentiment

GET /sentiment?ticker=general

Get Latest News

GET /news?ticker=general

View Analytics Summary

GET /analytics/summary

Comprehensive market snapshot.

3. Memecoin Screening

Fastest Growing

GET /memecoin/fastest-holder-growth

Smart Money Activity

GET /memecoin/most-mentioned-by-smart-money-x

Strong Narratives

GET /memecoin/strong-narrative-low-market-cap

Development Mode

Dev Routes (No Payment)

For local testing without x402 payments:

Local API
Production API

Point the playground to your local API:

VITE_API_BASE_URL=http://localhost:3000

Dev routes available at /endpoint/dev (no payment required).

VITE_API_BASE_URL=https://api.syraa.fun

All requests require x402 payment.

Tech Stack

Layer	Technology
Build	Vite, TypeScript
UI	React, shadcn-ui, Tailwind CSS
Wallet	@solana/wallet-adapter, Privy (Solana + Base + social)
Payment	@x402/core
API Client	Fetch API with x402 integration

Security

Best Practices:

Never share your wallet private keys
Verify payment amounts before approving
Use the playground on trusted networks only
Review transaction details in your wallet

Wallet Security: Your keys never leave your wallet extension
HTTPS Only: All requests use encrypted connections
Payment Verification: Transactions are verified on-chain
No Storage: Private data is not stored on servers

Troubleshooting

Wallet won't connect

Ensure wallet extension is installed and unlocked
Try refreshing the page
Check browser console for errors
Verify you’re on a supported network (Solana mainnet)

Payment transaction fails

Check wallet balance (sufficient SOL for transaction + fees)
Verify network is not congested
Try increasing transaction priority fee
Ensure wallet is connected to mainnet-beta

Request times out

Check API status at /check-status
Verify your internet connection
Try a simpler endpoint first
Check request parameters are valid

Invalid response format

Verify endpoint URL is correct
Check parameter names and values
Review API documentation for expected format
Try the same request in dev mode (local API)

Next Steps

API Reference

Complete endpoint documentation

MCP Server

Use API in Cursor/Claude

x402 Agent

Deploy autonomous agents

n8n Workflows

Automate with n8n

Platforms

Developer Tools

Automation

API Playground

Overview

Features

Supported Endpoints

Quick Start

x402 Payment Flow

Request Builder

Endpoint Selection

Parameter Configuration

Response Inspector

JSON Formatting

Response Metadata

Error Handling

Request History

History Actions

Example Workflows

1. Token Due Diligence

2. Market Overview

3. Memecoin Screening

Development Mode

Dev Routes (No Payment)

Tech Stack

Security

Troubleshooting

Next Steps

API Reference

MCP Server

x402 Agent

n8n Workflows

Build docs developers (and LLMs) love

Platforms

Developer Tools

Automation

​Overview

​Features

​Supported Endpoints

​Quick Start

​x402 Payment Flow

​Request Builder

​Endpoint Selection

​Parameter Configuration

​Response Inspector

​JSON Formatting

​Response Metadata

​Error Handling

​Request History

​History Actions

​Example Workflows

​1. Token Due Diligence

​2. Market Overview

​3. Memecoin Screening

​Development Mode

​Dev Routes (No Payment)

​Tech Stack

​Security

​Troubleshooting

​Next Steps

API Reference

MCP Server

x402 Agent

n8n Workflows

Build docs developers (and LLMs) love

Overview

Features

Supported Endpoints

Quick Start

x402 Payment Flow

Request Builder

Endpoint Selection

Parameter Configuration

Response Inspector

JSON Formatting

Response Metadata

Error Handling

Request History

History Actions

Example Workflows

1. Token Due Diligence

2. Market Overview

3. Memecoin Screening

Development Mode

Dev Routes (No Payment)

Tech Stack

Security

Troubleshooting

Next Steps