News
Menu
Explore Games
Votes reset in --

API Documentation

Integrate Web3GamesHub data directly into your own app.

Introduction

Welcome to the Web3GamesHub Developer API. You can use our API to fetch real-time voting data, analytics, and check if specific wallets have voted for your project today.

Base URL: https://web3gameshub.com


Authentication

Most endpoints require an API key tied to your specific project. You can generate one from your My Submits dashboard.

Pass your API key using one of two methods:

Method 1: HTTP Header (Recommended)

X-API-Key: ng_your_api_key_here

Method 2: Query Parameter

?api_key=ng_your_api_key_here

GET

/api/stats

Retrieve general statistics and historical daily voting data for your project.

Example Response

{
  "success": true,
  "message": "OK",
  "data": {
    "game": {
      "name": "My Epic Game",
      "slug": "my-epic-game",
      "chain": "Ethereum"
    },
    "this_month": "September 2026",
    "votes_total": 1250,
    "votes_month": 450,
    "views_total": 8500,
    "monthly_reset": "2026-10-01T00:00:00+00:00",
    "daily_votes": [
      {
        "date": "2026-09-01",
        "votes": "42"
      }
    ]
  }
}

GET

/api/check-vote

Check if a specific wallet address is currently allowed to vote for your project (enforces a 2-hour cooldown).

Parameter Type Description
wallet string (required) The EVM wallet address to check (e.g. 0x123...)

Example Response

{
  "success": true,
  "message": "OK",
  "data": {
    "wallet": "0x123...",
    "game": "my-epic-game",
    "can_vote": false,
    "voted_this_month": 5,
    "last_voted_at": "2026-09-12 14:00:00",
    "next_vote_at": "2026-09-13T02:00:00+00:00",
    "seconds_left": 14500,
    "cooldown_hours": 12,
    "monthly_reset": "2026-10-01T00:00:00+00:00"
  }
}