Skip to main content
No live events right now
Sign In
revolution.fanDocs
Get API Key

revolution.fan / docs

Platform Documentation

Everything you need to build on the only live-event data platform with real fan identity, verified attendance, and on-chain loyalty.

TypeScript SDKDrop in. Fan graph included.One import gives you verified fan identity, $FAN balance, attendance history, and real-time event context.TypeScript · React Native · Node.jsRead docs Python SDKpip install revolution-fanFull-featured Python client for data science, analytics pipelines, and backend integrations.Python · Jupyter · PandasRead docs Data MarketplaceQuery 500K+ verified fan profiles.License clean behavioural data segmented by genre, venue, city, and spend. Every row is consent-gated.B2B · Anonymised · Consent-gatedRead docs Seller PortalMonetise your fan data.List your first-party fan data on the marketplace. Set your price, define consent rules, earn revenue.Revenue Share · Self-serve · APIRead docs Event StreamThe live-event API layer.WebSocket streams for check-ins, drop events, autograph requests, and venue triggers, firing at door-scan.WebSockets · Webhooks · Real-timeRead docs Live StreamingGo live in 60 seconds.Browser-based WebRTC streaming or OBS/RTMP, no external platform. Set a $FAN paywall or stream free.WebRTC · RTMP · $FAN PaywallRead docs

Quick Start

Install the SDK and make your first call in under a minute.

# TypeScript / JavaScript
npm install @revolution/sdk

# Python
pip install revolution-fan
import { Revolution } from '@revolution/sdk';

const rev = new Revolution({ apiKey: 'rev_live_xxxx' });

// Discover tonight's events in Austin
const { items } = await rev.events.list({ region: 'atx', featured: true });
console.log(items[0].title); // "Khruangbin at Stubb's"

Get your API key at the developers portal. Free keys include read access to events, artists, and venues. Pro and Enterprise keys unlock commerce, marketplace queries, and the Event Stream.

Try the Sandbox, No Key Required

Want to explore the Data Marketplace before signing up? The public sandbox lets you run live queries against synthetic fan data with no API key.

Open Sandbox

Authentication

All requests require an API key. Three auth schemes are supported depending on key type:

bearerAuthorization: Bearer <key>Fan apps, artist/venue portals, admin
marketplaceX-Marketplace-Key: <key>B2B data buyers: labels, promoters, agencies
scannerX-Scanner-Key: <key>Venue RFID / QR check-in scanners
const rev = new Revolution({
  apiKey: 'rev_live_xxxx',
  authScheme: 'bearer',        // default
  defaultRegion: 'atx',        // optional
  timeout: 10_000,             // ms
});

Base URLs

Productionhttps://api.revolution.fan/api/v1
Staginghttps://revolution-fan-production.up.railway.app/api/v1

Rate Limits

Free60 req/minEvents, venues, artists (read)
Pro600 req/min+ Commerce, attendance
EnterpriseUnlimited+ Marketplace, Event Stream, priority support

OpenAPI / Postman

The full OpenAPI 3.0 spec is available at runtime. Import it into Swagger UI or Postman. A ready-made Postman collection covering all endpoints is available in the repo.

# OpenAPI spec
curl https://revolution-fan-production.up.railway.app/api/v1/openapi.yaml

# Postman collection — import from the repo
# docs/postman_collection.json

State of Fan Data 2026

The definitive data report on fan behavior, spending, and identity across music, sports, esports, and gaming. Includes first-party revolution.fan data alongside industry benchmarks.

Read the report
SDK docs Data MarketplaceGet API key