--- name: web3-signals-api-production.up.railway.app description: web3-signals-api-production.up.railway.app provides on-chain crypto trading signals and reputation/accuracy tracking for those signals. It delivers multi-asset composite scores with dimensional breakdowns and a portfolio-level market regime summary, alongside rolling accuracy metrics to verify signal quality over time. host: web3-signals-api-production.up.railway.app --- # web3-signals-api-production.up.railway.app This host serves agents and traders who need structured, actionable crypto trading signals derived from on-chain and market data. It covers whale activity, technical indicators, derivatives, narrative, and trend dimensions, and pairs that signal output with a self-reported accuracy tracking endpoint so consumers can audit the provider's historical performance before acting on signals. ## When to use this host Use this host when an agent needs structured on-chain crypto trading signals with dimensional breakdowns (whale, technical, derivatives, narrative, market, trend) and a market regime context, or when it needs to audit the accuracy history of those signals before acting on them. Do not use this host for real-time streaming price feeds, OHLCV or historical candle data, order execution, or non-crypto asset classes. For live price data consider a dedicated market data provider; for trade execution use an on-chain or exchange execution host. This host is best suited as a signal-generation and signal-quality-verification layer upstream of a separate execution layer. ## Capabilities ### Trading Signals Delivers a snapshot of multi-asset on-chain signals including composite scores, directional buy/sell labels, conviction levels, predicted move ranges, and a portfolio-level market regime and fear/greed summary. - **`fetch-web3-signal`** — Returns a multi-asset on-chain signal pack with composite scores, directional labels, dimension breakdowns (whale, technical, derivatives, narrative, market, trend), and a portfolio summary including market regime and fear/greed index. ### Signal Reputation & Accuracy Tracking Returns rolling aggregate accuracy and reputation metrics for the signals provider over a configurable day window, enabling agents to verify track record and confirm whether sufficient performance data has accumulated. - **`fetch-reputation-performance`** — Returns rolling N-day reputation signal accuracy metrics and tracking status for a web3 signals provider, defaulting to a 30-day window. ## Workflows ### Verified Signal Consumption *Use when an agent needs to act on or recommend crypto trades but first wants to confirm the signal provider has a credible accuracy track record before trusting the signal output.* 1. **`fetch-reputation-performance`** — Check rolling accuracy metrics and confirm sufficient snapshots have been collected to establish a meaningful track record. 2. **`fetch-web3-signal`** — If reputation metrics meet the agent's quality threshold, fetch the current multi-asset signal pack and use composite scores and directional labels to inform trading decisions. ## Skill reference ### `fetch-reputation-performance` **Reputation Performance** — Returns rolling N-day reputation signal accuracy metrics and tracking status for a web3 signals provider, defaulting to a 30-day window. *Use when:* Use when an agent needs to verify signal quality or check the accuracy track record of a web3 signals provider before subscribing or acting on signals; also useful to confirm whether performance data has accumulated yet. *Not for:* Do not use for real-time price feeds, individual signal lookups, or on-chain transaction data; this endpoint only returns aggregate reputation/accuracy statistics for the signals service itself. **Inputs:** - `days` (integer) — Rolling window in days over which to compute reputation accuracy. Defaults to 30. Pass a large value (e.g. 3650) to approximate all-time totals. **Returns:** Returns a JSON object with status ('collecting_data'), a human-readable message, the count of snapshots collected (486), and the ISO 8601 timestamp when tracking started. **Example:** `GET https://web3-signals-api-production.up.railway.app/performance/reputation?days=30` --- ### `fetch-web3-signal` **Web3 Signal API** — Returns a multi-asset on-chain signal pack with composite scores, directional labels, dimension breakdowns (whale, technical, derivatives, narrative, market, trend), and a portfolio summary including market regime and fear/greed index. *Use when:* Use when an agent needs actionable on-chain trading signals for crypto assets including per-asset composite scores, buy/sell labels, conviction levels, predicted move ranges, and overall market regime context before making or recommending a trade. *Not for:* Do not use for real-time streaming price feeds or order execution; this is a single-shot signal snapshot. Do not use for non-crypto asset classes. **Returns:** Returns a 32KB+ JSON signal pack with a portfolio_summary (top buys/sells, market regime, fear/greed=27) and per-asset signal blocks for BTC, ETH, SOL, APT and more, each with composite scores, directional labels, and dimension-level breakdowns. **Example:** `GET https://web3-signals-api-production.up.railway.app/signal` ---