--- name: api.syraa.fun description: api.syraa.fun provides Binance spot market data (exchange rules, 24h ticker stats, order book depth), asset correlation analysis, trading signals with technical indicators, and crypto news feeds. It covers the full pre-trade research stack from market structure to sentiment but does not execute trades or stream real-time data. host: api.syraa.fun --- # api.syraa.fun Syraa is a crypto research API serving agents that need to gather market intelligence before making or recommending trades. It combines Binance-specific market data with cross-asset correlation analysis, technical trading signals, and curated news — all as single-shot REST calls. It is not a trading execution layer, a streaming data provider, or a cross-exchange aggregator. ## When to use this host Use api.syraa.fun when an agent needs single-shot Binance spot market data (rules, stats, order book), cross-asset correlation rankings, technical trading signals, or current crypto news — all scoped to pre-trade research and analysis. Do not use this host for trade execution (no order placement endpoints exist), real-time streaming data (all responses are point-in-time snapshots), futures or margin market data, historical OHLCV candles, or cross-exchange data beyond Binance spot. For streaming order book or price feeds, use a WebSocket-based provider. For historical price series or OHLCV data, use a dedicated market data API such as CoinGecko or CryptoCompare. For on-chain data or wallet analytics, use a blockchain data provider. ## Capabilities ### Binance Market Structure Provides the foundational rules and constraints governing Binance spot trading, including symbol filters, order types, lot sizes, and rate limits needed to validate any order before submission. - **`fetch-binance-spot-exchange-info`** — Returns Binance spot market exchange metadata including server time, rate limits, and full trading rules for all listed symbols. ### Binance Spot Market Data Delivers snapshot market data for Binance spot pairs — 24-hour rolling statistics and live order book depth — enabling price discovery, spread analysis, and liquidity assessment. - **`fetch-binance-spot-24hr-ticker`** — Returns 24-hour rolling statistics for all Binance spot trading pairs, including price change, high/low, volume, and trade count. - **`fetch-binance-spot-depth`** — Returns the live Binance spot order book for a trading pair, including a list of bid and ask price/quantity levels and the last update ID. ### Asset Correlation Analysis Identifies which Binance-listed trading pairs move most closely with a given symbol, returning ranked correlation coefficients useful for hedging, diversification, and co-movement research. - **`fetch-binance-asset-correlation`** — Returns a ranked list of Binance trading pairs most correlated with a base symbol, with numeric Pearson-style correlation coefficients. - **`fetch-binance-correlation`** — Returns the top correlated trading pairs on Binance for a given symbol, with correlation coefficients for each pair. ### Trading Signals Generates structured BUY/SELL/HOLD signals for a specific token or instrument, including trend direction, technical indicators, price targets, and risk management parameters. - **`fetch-trading-signal`** — Returns a structured trading signal for a given token/instrument including trend analysis, technical indicators, price targets, and risk management parameters. ### Crypto News and Sentiment Supplies current crypto and blockchain news from multiple curated sources, either as trending importance-ranked headlines or as a paginated article feed, optionally scoped to a specific ticker. - **`fetch-trending-headlines`** — Returns a ranked list of trending crypto news headlines from aggregated sources, optionally filtered by ticker symbol, with importance scores and metadata. - **`fetch-crypto-news`** — Returns a paginated array of curated crypto and blockchain news articles from sources like CoinDesk, Decrypt, and BeInCrypto, optionally filtered by ticker symbol. ## Workflows ### Pre-Trade Research for a Single Asset *Use when an agent needs to build a complete picture of a specific Binance spot pair before recommending or placing a trade.* 1. **`fetch-binance-spot-exchange-info`** — Retrieve trading rules, lot size filters, and order constraints for the target symbol to confirm it is tradeable and understand its parameters. 2. **`fetch-binance-spot-24hr-ticker`** — Pull 24-hour price change, volume, and bid/ask stats to gauge current market momentum and liquidity. 3. **`fetch-binance-spot-depth`** — Inspect the live order book to assess spread and depth before sizing a position. 4. **`fetch-trading-signal`** — Obtain a structured BUY/SELL/HOLD signal with technical indicators and price targets to inform the trade decision. ### Correlation-Aware Portfolio Analysis *Use when an agent needs to evaluate diversification or hedging options relative to a held or target Binance asset.* 1. **`fetch-binance-asset-correlation`** — Identify the Binance pairs most correlated with the base symbol to find potential hedges or substitutes. 2. **`fetch-binance-spot-24hr-ticker`** — Check 24h stats for the correlated pairs to confirm they are actively traded with sufficient volume. 3. **`fetch-trading-signal`** — Fetch trading signals for the top correlated pairs to compare directional bias and risk parameters across candidates. ### News-Augmented Signal Review *Use when an agent needs to cross-check a technical trading signal against current market sentiment and news flow for a specific token.* 1. **`fetch-trading-signal`** — Generate the technical BUY/SELL/HOLD signal and risk parameters for the target token. 2. **`fetch-trending-headlines`** — Retrieve importance-ranked trending headlines for the same ticker to surface any breaking news that could invalidate or reinforce the signal. 3. **`fetch-crypto-news`** — Pull the broader curated news feed for the ticker to provide additional context from sources like CoinDesk and Decrypt. ## Skill reference ### `fetch-binance-spot-exchange-info` **Binance Spot Exchange Info** — Returns Binance spot market exchange metadata including server time, rate limits, and full trading rules for all listed symbols. *Use when:* Use when an agent needs to look up trading rules, order types, price filters, lot size constraints, or permission sets for any Binance spot trading pair before placing or validating an order. *Not for:* Do not use for real-time price quotes or order book data; use a market data or ticker endpoint instead. Not suitable for futures or margin-specific rule lookups. **Returns:** Returns a JSON object with timezone, serverTime, rateLimits array, empty exchangeFilters, and a symbols array containing full trading rules and filters for each Binance spot pair. **Example:** `GET https://api.syraa.fun/binance/spot/exchange-info` --- ### `fetch-binance-spot-24hr-ticker` **Binance Spot 24h Ticker** — Returns 24-hour rolling statistics for all Binance spot trading pairs, including price change, high/low, volume, and trade count. *Use when:* Use when an agent needs current 24-hour market statistics for Binance spot pairs such as last price, price change percent, bid/ask prices, volume, or trade count across all symbols. *Not for:* Do not use for real-time streaming price feeds or order book depth; this is a single-shot snapshot of 24h aggregated stats. Not suitable for futures or margin markets. **Returns:** Returns a JSON array of objects, one per trading pair, each containing symbol, priceChange, priceChangePercent, lastPrice, bid/ask prices, high/low, base and quote volume, open/close timestamps, and trade count. **Example:** `GET https://api.syraa.fun/binance/spot/ticker/24hr` --- ### `fetch-binance-spot-depth` **Binance Spot Order Book Depth** — Returns the live Binance spot order book for a trading pair, including a list of bid and ask price/quantity levels and the last update ID. *Use when:* Use when an agent needs the current bid and ask order book depth for a Binance spot trading pair to assess liquidity, spread, or market microstructure before placing or analyzing a trade. *Not for:* Do not use for historical order book snapshots or streaming real-time order book updates; use a WebSocket depth stream instead. Not suitable for futures or margin order books. **Returns:** Returns a JSON object with lastUpdateId (integer), bids (array of [price, qty] string pairs sorted descending), and asks (array of [price, qty] string pairs sorted ascending), reflecting the live Binance spot order book snapshot. **Example:** `GET https://api.syraa.fun/binance/spot/depth` --- ### `fetch-binance-asset-correlation` **Binance Asset Correlation** — Returns a ranked list of Binance trading pairs most correlated with a base symbol, with numeric Pearson-style correlation coefficients. *Use when:* Use when an agent needs to identify which Binance-listed assets move most similarly to a given base symbol (e.g., BTCUSDT) for portfolio analysis, hedging, or diversification decisions. *Not for:* Do not use for real-time price feeds or order book data; use a market data or ticker endpoint instead. Not suitable for cross-exchange correlation analysis. **Inputs:** - `symbol` (string, required) — The base Binance trading pair symbol to compute correlations against (e.g., BTCUSDT). **Returns:** Returns the base symbol (e.g., BTCUSDT) and a top-10 ranked array of correlated Binance pairs with numeric correlation coefficients, highest first. **Example:** `GET https://api.syraa.fun/binance/correlation?symbol=BTCUSDT` --- ### `fetch-binance-correlation` **Binance Market Correlation** — Returns the top correlated trading pairs on Binance for a given symbol, with correlation coefficients for each pair. *Use when:* Use when an agent needs to identify which Binance trading pairs move most closely with a target symbol, such as BTCUSDT, to inform hedging, diversification, or co-movement analysis. *Not for:* Do not use for real-time price quotes, order book data, or trade execution; use a dedicated Binance price or trading API instead. **Inputs:** - `symbol` (string, required) — The Binance trading pair symbol to fetch correlation data for. **Returns:** Returns the queried symbol and a top array of up to 10 correlated Binance pairs, each with a symbol name and a decimal correlation coefficient. **Example:** `GET https://api.syraa.fun/binance?symbol=BTCUSDT` --- ### `fetch-trading-signal` **MarketPulse Trading Signal** — Returns a structured trading signal for a given token/instrument including trend analysis, technical indicators, price targets, and risk management parameters. *Use when:* Use when an agent needs a machine-readable trading signal (BUY/SELL/HOLD) with supporting technical analysis, price targets, and risk parameters for a specific token or trading pair before making or recommending a trade. *Not for:* Do not use for streaming real-time price feeds or order execution; this is a single-shot signal snapshot. Not suitable for portfolio-level analysis across multiple assets simultaneously. **Inputs:** - `token` (string) — Token name for the signal (e.g., solana, bitcoin). - `instId` (string) — Venue symbol override; with source=coingecko use CoinGecko coin id (e.g. solana). Otherwise use the venue's native symbol (e.g. BTCUSDT). - `source` (string) — Data source/exchange. Default: binance. Options: binance, coinbase, coingecko, okx, bybit, kraken, bitget, kucoin, upbit, cryptocom. Use n8n or webhook for n8n integration. - `bar` (string) — Candle interval (default ~1h per venue). - `limit` (number) — Number of candles to use for analysis (venue max varies). **Returns:** Returns a signal object with TRADING_SIGNAL=HOLD, SIGNAL_STRENGTH=MEDIUM, full technical indicators (RSI, MACD, Bollinger Bands, ADX, MFI), price targets, risk management parameters, and an action plan for BTCUSDT on BINANCE_SPOT. **Example:** `{"token": "bitcoin", "source": "binance", "instId": "BTCUSDT", "bar": "1h", "limit": 200}` --- ### `fetch-trending-headlines` **TrendPulse Headlines** — Returns a ranked list of trending crypto news headlines from aggregated sources, optionally filtered by ticker symbol, with importance scores and metadata. *Use when:* Use when an agent needs current trending crypto or financial news headlines ranked by importance, optionally scoped to a specific asset ticker or general market news. *Not for:* Do not use for real-time price data or order book feeds; use a market data API instead. Not suitable for historical news archives — this returns current trending items only. **Inputs:** - `ticker` (string) — Ticker symbol to filter headlines (e.g. 'BTC', 'ETH') or 'general' for broad market news. Omit for all trending headlines. **Returns:** Returns a trendingHeadline array of ranked news objects, each containing headline, text excerpt, news_url, source_name, date, tickers array, and a floating-point importance score. **Example:** `{"ticker": "ETH"}` --- ### `fetch-crypto-news` **Syraa Premium Crypto News** — Returns a paginated array of curated crypto and blockchain news articles from sources like CoinDesk, Decrypt, and BeInCrypto, optionally filtered by ticker symbol. *Use when:* Use when an agent needs recent crypto or blockchain news headlines, URLs, publication timestamps, and source names — either for a specific token ticker (e.g. XRP, ETH) or a broad general feed. *Not for:* Do not use for real-time price quotes or OHLCV market data; use a market data API instead. Not suitable for historical news archives beyond what the feed returns. **Inputs:** - `ticker` (string) — Ticker symbol to filter news (e.g. 'XRP', 'ETH') or 'general' for a broad crypto news feed. Defaults to 'general' if omitted. **Returns:** Returns a news array where each item contains news_url, title, text, source_name, date, published_at, and a tickers array; articles span sources like CoinDesk, BeInCrypto, and Decrypt. **Example:** `{"ticker": "XRP"}` ---