Hero stats

GET

/api/v1/heroes/hero/{query}/stats

Heroes

Maintainer:Alastor

This endpoint retrieves detailed statistics for a specific hero based on their name or ID. The stats are fetched from an external API, and the response includes processed hero stats for analysis and display.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero//stats' \
--header 'x-api-key;'

Response Example

{
    "overall_stats": {
        "attack": 100,
        "defense": 80,
        "speed": 60,
        "health": 1500,
        "critical_hit": 10,
        "armor": 50
    },
    "damage_per_second": 350,
    "win_rate": "58%",
    "pick_rate": "22%",
    "ban_rate": "14%"
}

Request

Path Params

query

string

required

The name or ID of the hero to fetch stats for.

Example:

ironman

Header Params

x-api-key

string

required

The API key for authorization. It is necessary to provide a valid API key to access the data.

Example:

your-api-key-here

Responses

🟢200OK

application/json

Successful response with hero stats data

Body

overall_stats

object

optional

A collection of the hero's overall stats.

Example:

{"attack":100,"defense":80,"speed":60,"health":1500,"critical_hit":10,"armor":50}

damage_per_second

integer

optional

Calculated damage per second for the hero.

Example:

350

win_rate

string

optional

The win rate for the hero.

Example:

58%

pick_rate

string

optional

The pick rate for the hero.

Example:

22%

ban_rate

string

optional

The ban rate for the hero.

Example:

14%

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Modified at 2025-07-23 14:35:31

Search hero

Hero leaderboard