ReviewSignal

Help Center

Guides, tutorials, and answers to help you get the most from ReviewSignal.

🚀

Getting Started

Sign up, first login, and navigating the dashboard.

📊

Dashboard Guide

Understanding signals, charts, and data sections.

🔧

API Integration

Authentication, endpoints, and code examples.

🔔

Alerts & Notifications

Setting up sentiment alerts and email notifications.

💳

Billing & Plans

Subscription management, upgrades, and invoices.

🛠

Troubleshooting

Common issues and how to resolve them.

🚀 Getting Started
How do I sign up for a trial?
  1. Go to reviewsignal.ai/trial/
  2. Enter your work email, name, and company
  3. You'll receive a welcome email with your login credentials, while your one-time trial API key is shown immediately after signup
  4. Log in at reviewsignal.ai/login
  5. Complete the onboarding wizard to customize your experience

Your free trial includes 14 days of access with 100 API calls and coverage of 5 chains.

How do I log in for the first time?

After signing up, check your email for a message from team@reviewsignal.ai containing your password. Then:

  1. Go to reviewsignal.ai/login
  2. Enter your email and the password from the welcome email
  3. New users are automatically directed to the onboarding wizard

If you didn't receive the email, check your spam folder or contact team@reviewsignal.ai.

What is the onboarding wizard?

The onboarding wizard helps personalize your dashboard in 5 steps:

  1. Welcome — Overview of what ReviewSignal offers
  2. Industries — Select which sectors you track (QSR, retail, drugstores, etc.)
  3. Alerts — Configure your first sentiment alert
  4. Connect — Optional integration setup and handoff to Billing > API Access for Stripe-managed API key operations
  5. Complete — You're ready to go!

You can skip the wizard and come back later from your dashboard settings.

📊 Dashboard Guide
How do trading signals work?

Trading signals are generated by analyzing consumer sentiment trends across monitored chains. They are research inputs, not standalone trading recommendations. Each signal includes:

  • Signal — BUY, HOLD, or SELL directional label
  • Confidence — Runtime evidence strength when supported by live payloads
  • Sentiment Delta — 7-day change in average sentiment using review event time when available
  • Review Count — Number of reviews analyzed

Signals refresh on the monitored data pipeline and carry caveats when data is sparse or engine output is unavailable. Available from the Signal tier and above.

What does the 3D globe show?

The interactive 3D globe displays live location sentiment points from the current monitored workspace with color-coded sentiment:

  • Green — Positive sentiment (score > 0.2)
  • Yellow — Neutral sentiment
  • Red — Negative sentiment (score < -0.2)

Points are geo-clustered to 2 decimal places for performance. Hover over points to see location details. Data is cached for 1 hour in Redis.

Why are some sections locked?

Dashboard sections are gated by subscription tier. Locked sections show a blur overlay with the required tier and price. To open additional access:

  1. Click the "Upgrade" button on any locked section
  2. Or go to Billing & Subscription in the sidebar
  3. Select your plan and complete checkout where Stripe is available, or contact the team for provisioned workspaces

Main coverage ladder: Trial → Signal (€299) → Starter (€999) → Professional (€2,500) → Enterprise (custom scope via sales).

Developer Program (€1,500) is the side plan for API-first teams that want Starter-level coverage with webhook delivery, more API keys, and integration support.

What is the Backtest Track Record?

The Track Record section is only shown as proof when the runtime has a validated stored set. Metrics can include:

  • Pearson Correlation — Statistical correlation between weekly sentiment change and stock returns
  • Directional Agreement — Share of comparable periods where sentiment and price direction aligned
  • Sentiment Strategy Diagnostic — Risk-adjusted diagnostic when the stored evidence supports it

The Track Record section only acts as external proof when a validated stored set is present. If the runtime package is in watchlist or empty mode, the dashboard marks that state explicitly instead of claiming validated proof. Available for Professional tier and above.

🔧 API Integration
How do I authenticate with the API?

ReviewSignal supports two authentication modes:

  • JWT for session-style routes like /api/dashboard/* and /api/billing/*: Authorization: Bearer YOUR_JWT_TOKEN
  • API key for direct integration routes under /api/v1/*: X-API-Key: rs_your_live_api_key

Get your JWT via POST /api/auth/login and renew it with POST /api/auth/refresh. Create or revoke API keys in Billing > API Access. See the Developer Portal for the full route map.

What are the API rate limits?
  • Trial: 100 calls total (14-day window)
  • Signal: 1,000 calls/day
  • Starter: 5,000 calls/day
  • Developer Program: 15,000 calls/day
  • Professional: 25,000 calls/day
  • Enterprise: Custom high-volume limits

If you exceed your limit, the API returns 429 Too Many Requests. Use exponential backoff to retry. Check your current usage at Billing.

Where can I find the full API reference?
  • Developer Portal — Quick start, code examples, tier access
  • Swagger UI — Interactive API explorer (try requests live)
  • ReDoc — Clean API reference documentation
  • OpenAPI JSON — Machine-readable schema for code generation
🔔 Alerts & Notifications
How do I set up a sentiment alert?
  1. Go to the Dashboard and find the Alerts section (or use the API)
  2. Click "Create Alert Rule"
  3. Choose trigger type: sentiment drop, anomaly detection, or volume spike
  4. Set the threshold (e.g., sentiment drops below -0.3)
  5. Choose notification method (email)

Alert limits by tier: Trial (2), Signal (5), Starter (10), Developer Program (10), Professional (25), Enterprise (custom).

How do I unsubscribe from emails?

Every email from ReviewSignal includes an unsubscribe link in the footer. You can also:

  • Click the "Unsubscribe" link in any email
  • Email team@reviewsignal.ai with "Unsubscribe" in the subject

Per GDPR, we process your opt-out immediately. You can re-subscribe by contacting us.

💳 Billing & Plans
How do I upgrade my plan?
  1. Go to Dashboard → Billing
  2. Click "Upgrade" on the plan you want
  3. Complete payment via Stripe Checkout
  4. Your tier is upgraded immediately

You can also upgrade by clicking any "Upgrade" button on locked dashboard sections.

How do I cancel my subscription?

Stripe-managed subscriptions can be cancelled from the Billing page:

  1. Go to Dashboard → Billing
  2. Click "Manage in Stripe"
  3. Select "Cancel subscription" in the Stripe portal

You keep full access until the end of your current billing period. After that, your account reverts to the free tier. Data is retained for 90 days. Provisioned workspaces and invoice-based arrangements should contact team@reviewsignal.ai for changes.

Where can I find my invoices?

For Stripe-managed workspaces, click "Manage in Stripe" on the Billing page. The Stripe Customer Portal shows invoices, receipts, and payment history there. Provisioned workspaces should contact team@reviewsignal.ai.

🛠 Troubleshooting
I can't log in — what should I do?
  • Check your email — Make sure you're using the email from your welcome message
  • Check your password — Copy-paste from the welcome email to avoid typos
  • Trial expired? — If your 14-day trial ended, you'll see a message prompting you to upgrade
  • Too many attempts? — Wait 5 minutes if you see "Too many login attempts"
  • Still stuck? — Use Forgot Password or email team@reviewsignal.ai
I'm getting API errors (401, 403, 500)
  • 401 Unauthorized — Your token is missing or expired. Re-login via POST /api/auth/login
  • 403 Forbidden — Your tier doesn't include this feature. Upgrade your plan
  • 429 Rate Limited — You've exceeded your API call quota. Wait and retry with backoff
  • 500 Server Error — Something went wrong on our side. Email team@reviewsignal.ai with the request details
Dashboard charts show no data
  • Click "Refresh" in the top-right header bar
  • Check your tier — Some charts require Signal tier or higher
  • Check filters — If you selected a specific chain/city, it may have limited data
  • Wait for data — New trial accounts may need a few minutes for data to load

If the issue persists, try clearing your browser cache or using an incognito window.

Still need help?

Our team typically responds within 4 hours during business days (CET).