Datacentre REST API

#Base URL and access

• Public base URL: https://services.soccerverse.com/api
• Live OpenAPI source: GET /openapi.json
• All documented routes are GET.
• Some protected/test environments require a Cloudflare bypass header. Use the placeholder only; never commit or print the value:

-H "x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET"

#Common response and money notes

• Paged endpoints generally return { page, per_page, total, total_pages, items }.
• Some data endpoints return raw arrays; dump endpoints often return { meta, data } or a file download.
• Money/SVC values from REST/MySQL are raw scaled integers unless the endpoint explicitly says otherwise. Divide raw money fields by 10000 to present SVC. Example: 1234567 raw = 123.4567 SVC. Do not divide fields that are already documented as USD, USDC, percentages, counts, ratings, ages, timestamps, or prices from a dump that explicitly says it is converted.
• Array filters are accepted as query parameters by FastAPI; examples here use one value, e.g. club_id=50, player_id=1100, names=snailbrain.

#Quick start

# Health check
curl -sS \
  -H "x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET" \
  "https://services.soccerverse.com/api/healthz" | jq .

# Club lookup using the sample club_id
curl -sS \
  -H "x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET" \
  "https://services.soccerverse.com/api/clubs?club_id=50&per_page=5" | jq .items[0]

# Player lookup using the sample player_id
curl -sS \
  -H "x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET" \
  "https://services.soccerverse.com/api/players?player_id=1100&per_page=5" | jq .items[0]

# User lookup using the sample username
curl -sS \
  -H "x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET" \
  "https://services.soccerverse.com/api/users/detailed?names=snailbrain&per_page=5" | jq .items[0]

#System

Operational health of the public Datacentre app.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/healthz' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/healthz", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Do not document or expose /metrics; it is intentionally excluded from the public app.

#Clubs

Club market, detailed club records, job postings and weekly club balance sheets.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/clubs?club_id=50&per_page=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/clubs?club_id=50&per_page=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.
• /clubs/{club_id}/job returns 404 when the club has no public job posting; that is a valid no-job result, not proof the route is broken.

#Players

Player search/detail, historical transfers/loans/morale and combined player history.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/players?player_id=1100&per_page=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/players?player_id=1100&per_page=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.

#Users/profile

User lookup, profile/trading details, achievements and balance-sheet/earnings views.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/users/detailed?names=snailbrain&per_page=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/users/detailed?names=snailbrain&per_page=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.

#Reference/leagues/countries

Reference country/league data and current league-table snapshots.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/countries?country_id=ENG' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/countries?country_id=ENG", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• League IDs are season-specific; prefer country_id + division + season_id when linking historical data.

#Market/trading

Market overview, account/share balances, recent trades, leader/rich lists and trading graphs.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/market' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/market", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.

#Datacentre dumps/snapshots

Pre-calculated bulk snapshots for earnings, pack deals and order books. These can be larger than normal paged API responses.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/dumps/player_earnings?threshold=10&limit=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/dumps/player_earnings?threshold=10&limit=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.
• Dump endpoints can be large; prefer filtered endpoints (ids, threshold, limit) where available.
• /dumps/share_orders/csv returns CSV and /dumps/share_orders/json returns a downloadable JSON file rather than the normal paged wrapper.

#Shop datacentre

Pack-sale data for clubs in the shop/datacentre flow.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/shop/clubs?club_ids=50&per_page=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/shop/clubs?club_ids=50&per_page=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Use per_page/filters where available to keep responses small and cache-friendly.

#Transfers

Recent completed transfers and transfer-count summaries.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/transfers/basic' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/transfers/basic", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.

#Fixtures/commentary

Fixture commentary, match events, player stats and tactics snapshots.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/commentary/match_commentary/1' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/commentary/match_commentary/1", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Use a real fixture_id; examples here use fixture 1 as a stable reference value.

#Messages/news

Blockchain/game messages/news filtered by season, country, competition or club.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/messages?season_id=1&club_id=50&limit=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/messages?season_id=1&club_id=50&limit=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• season_id is required; add limit to avoid very large responses.

#Leaderboards

Earnings and referral leaderboards.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/leaderboards/earnings?days=30' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/leaderboards/earnings?days=30", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Check whether money-like fields are raw scaled integers and divide by 10000 only for raw SVC/money fields.

#Votes/proposals

Active and historical proposal/vote views plus graph data.

Example curl:

curl -sS \
  -H 'x-cf-bypass-secret: $CLOUDFLARE_BYPASS_SECRET' \
  'https://services.soccerverse.com/api/proposals/active?club_id=50&per_page=5' | jq .

Example Python:

import os
import requests

headers = {}
if os.getenv("CLOUDFLARE_BYPASS_SECRET"):
    headers["x-cf-bypass-secret"] = os.environ["CLOUDFLARE_BYPASS_SECRET"]

response = requests.get("https://services.soccerverse.com/api/proposals/active?club_id=50&per_page=5", headers=headers, timeout=30)
response.raise_for_status()
print(response.json())

Pitfalls:

• Active proposal lists may legitimately be empty for a specific club/player.