Realnaps Virtual Football Router

Build with the Realnaps Wire.

Integrate live virtual football fixtures, opening 1X2 odds, match results, and AI-driven predictions directly into your application. RESTful JSON endpoints designed for developers and researchers.

Base URLhttps://virtual-games.realnaps.com/api/v1

Authentication & Headers

Data routes take your API key in the x-api-key header — create keys on your dashboard. Keys in the URL are refused. Each response carries X-Quota-Limit / X-Quota-Remaining for your daily quota (resets 00:00 UTC) and X-RateLimit-* for the per-minute limit. Account endpoints use your sign-in session token. Everything is application/json. Send a User-Agent that names your app (-A "your-app/1.0" in curl): curl's default one is blocked by our firewall.

GET/api/v1/data/fixturesUpcoming fixtures & odds

Auth: x-api-keyMatches that have not kicked off yet, soonest first, with every market price the bookmaker offers.

Filters: marker, provider, team, opponent, week, date_from, date_to (YYYY-MM-DD), hour (0-23), market + min_odds/max_odds, limit (max 200), page. A match in "scheduled" status has result: null.

Example Request (cURL)

curl -A "your-app/1.0" "https://virtual-games.realnaps.com/api/v1/data/fixtures?provider=betking&limit=10" \
  -H "x-api-key: rn_live_your_key"

Example Response (JSON)

{
  "success": true,
  "data": [ { ...match, "status": "scheduled", "result": null, "markets_won": null } ],
  "meta": { "page": 1, "per_page": 10, "total": 30, "last_page": 3 }
}

GET/api/v1/data/resultsSettled results

GET/api/v1/data/rounds/latestLatest round per competition

GET/api/v1/data/stats/marketsMarket hit rates

GET/api/v1/data/competitions · /markets · /teamsCompetitions, markets and teams

POST/api/v1/data/predictionsSubmit a prediction

GET/api/v1/data/predictionsYour graded prediction history

Auth: x-api-keyEvery prediction with each pick graded won, lost or pending, plus your overall hit rate and flat-stake ROI.

Filter by model_label to compare models. /api/v1/data/predictions/latest returns only the newest one. The older paths /public/historic-predictions and /public/last-prediction still work.

Example Request (cURL)

curl -A "your-app/1.0" "https://virtual-games.realnaps.com/api/v1/data/predictions?model_label=goals-v2" \
  -H "x-api-key: rn_live_your_key"

Example Response (JSON)

{
  "success": true,
  "data": [ { "id": "…", "model_label": "goals-v2", "picks": [ ... ], "record": { "won": 6, "lost": 3, "pending": 1 } } ],
  "summary": { "picks": 10, "won": 6, "lost": 3, "pending": 1, "hit_rate": 0.6667, "profit_units": 1.84, "roi": 0.2044 }
}

GET/api/v1/healthSystem health

POST/api/v1/end-user/auth/registerRegister End-User Account

POST/api/v1/end-user/auth/loginEnd-User Sign In

GET/api/v1/end-user/meCurrent Member Profile

DELETE/api/v1/end-user/auth/logoutRevoke Access Token (Sign Out)

Authentication & Headers

Ready to query the stadium?