Skip to main content

Endpoint

GET  /signal
POST /signal

Description

Generates AI-powered trading signals with entry prices, target levels, stop losses, and market analysis for cryptocurrency trading.

Pricing

$0.01 USD per request (paid in USDC via x402)

Parameters

token
string
default:"bitcoin"
Token name for signal generation (e.g., bitcoin, ethereum, solana)

Request Examples

GET Request

curl -X GET "https://api.syraa.fun/signal?token=bitcoin"

POST Request

curl -X POST https://api.syraa.fun/signal \
  -H "Content-Type: application/json" \
  -d '{"token": "ethereum"}'

Solana Signal

curl -X GET "https://api.syraa.fun/signal?token=solana"

Response

signal
object
Trading signal with recommendations

Success Response

{
  "signal": {
    "token": "Bitcoin",
    "recommendation": "BUY",
    "confidence": "HIGH",
    "entry_price": 67500,
    "targets": [70000, 72500, 75000],
    "stop_loss": 65000,
    "analysis": "Strong bullish momentum with increasing volume. RSI at 58 indicates room for upside. Moving averages showing golden cross formation. Market sentiment remains positive with institutional accumulation.",
    "indicators": {
      "rsi": 58.3,
      "macd": "bullish",
      "volume_trend": "increasing",
      "ma_50": 66200,
      "ma_200": 64800
    },
    "timestamp": "2026-03-03T10:00:00Z"
  }
}

Error Responses

500 Internal Error

{
  "error": "Failed to fetch signal"
}

Server Error

{
  "error": "Server error"
}

Signal Generation

Signals are generated through N8N webhook:
const signal = await fetch(
  `${process.env.N8N_WEBHOOK_URL_SIGNAL}?token=${token}`
).then(r => r.json());
The AI analyzes:
  • Technical indicators (RSI, MACD, Moving Averages)
  • Volume trends and patterns
  • Market sentiment
  • Historical price action
  • On-chain metrics

Recommendation Types

BUY Signal

  • Strong bullish indicators
  • Favorable risk/reward ratio
  • Positive market sentiment
  • Entry price and multiple targets provided

SELL Signal

  • Bearish technical setup
  • Deteriorating fundamentals
  • Risk of downside continuation
  • Exit levels recommended

HOLD Signal

  • Sideways consolidation
  • Mixed indicators
  • Awaiting confirmation
  • No immediate action required

Confidence Levels

  • HIGH: Multiple confirming indicators, strong conviction
  • MEDIUM: Some confirming signals, moderate confidence
  • LOW: Uncertain conditions, proceed with caution

Code Example

// Get Ethereum signal
const response = await fetch('https://api.syraa.fun/signal?token=ethereum');
const { signal } = await response.json();

console.log(`${signal.token}: ${signal.recommendation}`);
console.log(`Confidence: ${signal.confidence}`);
console.log(`Entry: $${signal.entry_price}`);
console.log(`Targets: ${signal.targets.join(', ')}`);
console.log(`Stop Loss: $${signal.stop_loss}`);
console.log(`\nAnalysis: ${signal.analysis}`);

Risk Management

// Calculate position size based on risk
const riskPercentage = 0.02; // 2% risk
const accountBalance = 10000;
const riskAmount = accountBalance * riskPercentage;

const stopDistance = signal.entry_price - signal.stop_loss;
const positionSize = riskAmount / stopDistance;

console.log(`Position size: ${positionSize.toFixed(4)} ${signal.token}`);

Best Practices

  1. Always Use Stop Loss: Never trade without stop loss
  2. Position Sizing: Risk only 1-2% per trade
  3. Confirm Signals: Use multiple signals for confirmation
  4. Market Conditions: Consider broader market context
  5. Not Financial Advice: Signals are for informational purposes only

Important Disclaimer

Trading signals are for informational and educational purposes only. They do not constitute financial advice. Always conduct your own research and consider your risk tolerance before trading. Past performance does not guarantee future results.

Build docs developers (and LLMs) love