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"
}
}