All Balances

GET https://marvelrivalsapi.com/api/v1/balances

Retrieves all available balances with optional pagination to control the number of results per page

Headers

Name	Value
Content-Type	application/json
x-api-key*	YOUR API KEY

Query Parameters

Name	Type	Required	Description
page	integer	❌	The page number to fetch (defaults to 1).
limit	integer	❌	The number of balances to return per page (defaults to 10)

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/balances?page=1&limit=10"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/balances?page=1&limit=10", {
        headers: {
            "x-api-key": "YOUR_API_KEY"
        }
    });
    console.log(response.data);
} catch (error) {
    console.error("Error fetching balances:", error.response ? error.response.data : error.message);
}

Python

import requests

url = "https://marvelrivalsapi.com/api/v1/balances?page=1&limit=10"
headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error {response.status_code}: {response.text}")

Java

import java.net.http.*;
import java.net.URI;
import java.io.IOException;

public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://marvelrivalsapi.com/api/v1/balances?page=1&limit=10"))
            .header("x-api-key", "YOUR_API_KEY")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

Response

200

{
    "total_balances": 3,
    "balances": [
        {
            "id": "20250221-balance",
            "title": "Marvel Rivals Version 20250221 Balance Post - Season 1.5!",
            "date": "2025/02/19",
            "overview": "We're excited to kick off Season 1.5 right away with some refinement to our Super Heroes and Villains.",
            "fullContent": "ADJUSTMENTS\n\nDear Rivals!\n\n \n\nWe're excited to kick off Season 1.5 right away with some refinement to our Super Heroes and Villains. As a reminder, players can look forward to comprehensive adjustments to Team-Up abilities beyond numerical tweaks starting in Season 2. Without further ado, let’s get straight into the Balance Adjustments!\n\n \n\n\nVANGUARD\n\n \n\nCaptain America\n\nSteve will receive some enhanced survivability, his Vibranium Energy Saw will feel smoother, and his Ultimate Ability will be more attainable thanks to a reduced energy cost.\n\n- He will be able to shield himself with Living Legend mid-leap.\n\n- Increase Vibranium Energy Saw's projectile speed from 60m/s to 80m/s, with ricochets ramping up from 100m/s to a supercharged 150m/s.\n\n- Reduce the energy cost of Freedom Charge (ultimate ability) from 3100 to 2800.\n\n- Enhance Captain America's combat experience by separating Sentinel Strike from melee attacks. Captain America will be able to use melee attacks while his shield is thrown or during the Team-Up Ability Charged Aegis state to activate the first two hits of Sentinel Strike. Additionally, while airborne, using melee attacks will no longer trigger the Super-Soldier Slam ability.\n\n \n\nDoctor Strange\n\nOur beloved Sorcerer Supreme will take a modest hit to his survivability.\n\n- Reduce base health from 650 to 600.\n\n \n\nGroot\n\nWe'll be increasing the threat range of everyone's favorite Flora Colossus.\n\n- Increase Thornlash Wall placement range from 15 meters to 18 meters.\n\n \n\nMagneto\n\nThe Master of Magnetism will experience a slight dip in survivability but will be compensated with a small surge in offensive ability.\n\n- Increase Iron Volley projectile damage from 35 to 40.\n\n- Increase Metallic Curtain's energy consumption from 50/s to 65/s; Reduce its Maximum Duration from 2s to 1.5s.\n\n \n\nThor\n\nThe mighty Asgardian will offer a greater user experience after unleashing Awakening Rune. Unleash the thunder!\n\n- Remove the shared cooldown time after the duration of Awakening Rune ends.\n\n \n\nVenom\n\nThe symbiote menace will enter the fray more menacing than ever, with a heightened threat upon entering the battle and a leaner energy appetite for his Ultimate Ability.\n\n- Adjust the knock back effect of Frenzied Arrival from vertical to inward, with an inward knockback angle of 75°.\n\n- Reduce the energy cost of Feast of the Abyss (ultimate ability) from 2800 to 2500.\n\n \n\n\nDUELIST\n\n \n\nBlack Widow\n\nNatasha's combat effectiveness has been enhanced, increasing the threat level to enemies after using her Ultimate Ability.\n\n- Increase the magazine capacity of the Red Room Rifle from 8 to 15.\n\n- Enhance the slow effect of Electro-Plasma Explosion (Ultimate Ability) on enemies from 80% to 55%. Additionally, it will apply a 15% Vulnerability effect to hit enemies for 4 seconds.\n\n \n\nHawkeye\n\nWe're sharpening Clint’s survival instincts and honing his close-quarters capabilities, while his Ultimate Ability takes aim with greater peril.\n\n- Increase base health from 250 to 275.\n\n- Reduce projectile damage of Blast Arrow from 20 to 15, while the spell field damage will be increased from 25 to 32.\n\n- Reduce the cooldown time for Crescent Slash from 15s to 12s.\n\n- Increase bow draw speed during the duration of Hunter's Sight (Ultimate Ability) and raise damage multiplier from 1.2 to 1.35.\n\n \n\nHela\n\nThe Asgardian goddess of death will cast a longer shadow with an increase to her mid-to-long-range suppression.\n\n- The Damage Falloff of Nightsword Thorn at 30 meters will be changed from 70% to 80%.\n\n \n\nIron Fist\n\nLin Lie will bring fresh techniques to the martial arts mix, enhancing his Yat Jee Chung Kuen with both fortitude and finesse.\n\n- Reduce the damage of Jeet Kune Do's 1st, 2nd, and 5th strikes from 32 to 30, while the 3rd and 4th strikes will deal 15 damage instead of 16. The final, devastating 6th strike has been dialed back from 55 to 50. The cooldown reduction for Dragon's Defense has been extended from 1s to 1.5s. The damage of each hit from Yat Jee Chung Kuen will take a hit, dropping from 19 to 10 flat damage (including during Living Chi). However, each strike from the Yat Jee Chung Kuen now delivers an extra blow, dealing damage equal to 1.7% of the opponent's maximum health (including during Living Chi).\n\n- Increase the additional maximum health granted by Harmony Recovery from 50 to 150. A new decay mechanism for the extra health has also been introduced: one second after the ability ends, the additional health will deplete at a rate of 25 health per second.\n\n- Increase the maximum Bonus Health converted from damage blocked during Dragon's Defense from 150 to 200.\n\n- Increase base health from 250 to 300.\n\n \n\nIron Man\n\nTony will crank up the heat with his Unibeam, ensuring that even without Gamma Overdrive, foes will feel the burn.\n\n- Increase Unibeam damage from 120/s to 140/s.\n\n- Increase Unibeam (Armor Overdrive) damage from 180/s to 190/s.\n\n \n\nMagik\n\nThe Queen of Limbo will see her damage capability be slightly reduced, but the energy cost to unleash her Ultimate Ability will be slightly lowered. It’s time to behold Darkchild!\n\n- Decrease the damage dealt by Demon's Rage (regular state) from 80/s to 72/s.\n\n- Reduce the energy cost of Darkchild (ultimate ability) from 3700 to 3400.\n\n \n\nMister Fantastic\n\nReed will stretch his nuisance factor with a greater impact from his Ultimate Ability.\n\n- Increase the spell field radius after landing from Flexible Elongation from 2.5 meters to 5 meters. Additionally, Flexible Elongation will now feature a knockback effect, launching enemies outward within the area upon landing. The recharge time for a single use of Flexible Elongation will be adjusted from 8s to 10s.\n\n- Increase the damage of Brainiac Bounce (Ultimate Ability) spell from 50 to 70. Increase the energy cost from 2800 to 3400. Additionally, a new damage decay mechanism has been introduced: spell field damage will begin to decrease starting at 3 meters and will reach a maximum reduction of 50 at 10 meters.\n\n \n\nMoon Knight\n\nThe Hand of Khonshu will offer improved reaction times for foes and an optimized damage logic.\n\n- Reduced the Hand of Khonshu talons falling speed.\n\n- Correct the damage trigger logic for Hand of Khonshu. The previous mechanism that dealt 75 damage when positioned at the center of the spell field has been removed. Increase the damage of each hit from 75 to 150.\n\n \n\nScarlet Witch\n\nWe're boosting her survivability when unleashing her Ultimate Ability.\n\n- Gain an additional 100 Bonus Health upon activating Reality Erasure (Ultimate Ability). After the ability ends or is interrupted, this Bonus Health will decay at a rate of 50/s.\n\n \n\nSpider-Man\n\nWe're slightly reducing Web-Cluster cooldown to increase his offense.\n\n- Reduce Web-Cluster energize time from 3s to 2.5s.\n\n \n\nStar-Lord\n\nPeter's mobility is getting a stellar upgrade.\n\n- Increase Rocket Propulsion's maximum energy from 1200 to 1800.\n\n \n\nStorm\n\nWe've toned down her tempest from long range and recalibrated her bonuses, offering less of a boost to herself but more to her allies in the eye of the storm.\n\n- The Damage Falloff of Wind Blade at 30 meters will be changed from 70% to 60%.\n\n- Reduce Storm's damage increase from Thunder during Weather Control from 16% to 12%. However, the damage increase for allies within range has been increased from 8% to 10%.\n\n- Reduce Storm's damage increase from Enhanced Thunder during Weather Control from 30% to 25%.\n\n \n\n\nSTRATEGIST\n\n \n\nAdam Warlock\n\nAdam's damage capability will be enhanced, along with a slight increase in healing ability after activating Soul Bond.\n\nIncrease the damage of Quantum Magic from 55 to 60. Additionally, the Damage Falloff at 40 meters will be changed from 50% to 60%.\n\nIncrease the healing amount provided by Soul Bond to linked allies from 10/s to 15/s.\n\n \n\nCloak & Dagger\n\nSurvivability and healing ability during the activation of their Ultimate Ability will be increased, while the frequency, duration, and intensity of the Ultimate Ability reduced. Additionally, Tyrone’s threat level will be enhanced.\n\n \n\n· Increase the energy cost to activate Eternal Bond (Ultimate Ability) from 3400 to 4000. The healing amount of each segment will be increased from 220/s to 250/s, the duration will be reduced from 10s to 8s, and the pause time between segments decrease from 1s to 0.67s. Now, the healing effect from each segment will not stack; when overlapping, only one healing effect is applied. Additionally, camera control is unlocked during the activation of Eternal Bond.\n\n \n\n· Increase the Vulnerability inflicted on enemies by Terror Cape from 20% to 28%.\n\n \n\nInvisible Woman\n\nWe're reducing the frequency of her Ultimate Ability.\n\n- Increase the energy cost of Invisible Boundary (ultimate ability) from 4000 to 4300.\n\n \n\nLoki\n\nWe're reducing the trickster god's Ultimate Ability frequency, while slightly enhancing his survivability.\n\n- Increase the energy cost of God of Mischief (ultimate ability) from 3400 to 4000.\n\n- Increase Mystical Missile charges from 10 to 12.\n\n \n\nLuna Snow\n\nWe're reducing her Ultimate Ability frequency.\n\n- Increase the energy cost to activate Fate of Both Worlds (Ultimate Ability) from 4000 to 4500.\n\n \n\n\nTEAM-UP ABILITIES\n\n \n\nAtlas Bond\n\nWe'll be enhancing the capability of Luna Snow's side of this Team-Up ability.\n\n- Increase the healing amount of Frozen Chi from 50 to 75, and the slow effect on enemies from 20% to 30%.\n\n \n\nDimensional Shortcut\n\nWe're increasing the sustained combat capabilities of Black Panther and Psylocke.\n\n- Reduced the Rewind Time for Psionic Disc from 5s to 3s. Additionally, the conversion ratio of lost health to blue armor will be increased from 0.5 to 0.8.\n\n- Reduced the Rewind Time for Wakandan Master from 5s to 3s. Additionally, the conversion ratio of lost health to blue armor will be increased from 0.5 to 0.8.\n\n \n\nGamma Charge\n\nWe're reducing the damage capability of Gamma Overdrive, and Hulk's benefits from the team-up.\n\n- Reduce Unibeam (Gamma Overdrive) damage from 220/s to 200/s.\n\n- Reduce Hulk's Team-Up Anchor health bonus from 150 to 100.\n\n \n\nLunar Force\n\nWe're enhancing Moon Knight's survivability after using the Team-Up Ability.\n\nFull Moon New Effect: Continuously heal Moon Knight for 25 health per/s while within the effect area.\n\n \n\nSymbiote Bond\n\nPeni Parker and Spider-Man will enjoy enhanced survivability thanks to Suit/Armor Expulsion enhancements.\n\nReduce Spider-Man's Suit Expulsion duration from 4s to 1s. Replace the 50% damage reduction effect with a new invincibility effect during the duration.\n\nReduce Peni Parker's Armor Expulsion duration from 4s to 2s. Replace the 50% damage reduction effect with a new invincibility effect during the duration.\n\n \n\nFor more information about us, check out and follow our other social channels.\n\nDiscord [https://discord.gg/marvelrivals]|X [https://twitter.com/MarvelRivals]|Facebook [https://www.facebook.com/marvelrivals]|Instagram [https://www.instagram.com/marvelrivals/]|TikTok [https://www.tiktok.com/@marvelrivals]|YouTube [https://www.youtube.com/@MarvelRivals]|Twitch [https://www.twitch.tv/marvelrivals]",
            "imagePath": "/balances/balance_20250221.jpg"
        },
  ]
}

400

{
  "error": true,
  "message": "Invalid pagination parameters.",
  "status": 400
}

401

{
  "error": true,
  "message": "Invalid or missing API key.",
  "status": 401
}

404

{
  "error": true,
  "message": "No balances found",
  "status": 404
}

500

{
  "error": true,
  "message": "An error occurred while fetching data.",
  "status": 500
}

Response Field Descriptions

Field	Type	Description
total_balances	integer	The total amount of balances
balances	array	All balances
balances[].id	string	The id of the balance post
balances[].title	string	The title of the balance post
balances[].date	string (YYYY-MM-DD)	The date the balance post was posted
balances[].overview	string	A brief overview of the balance
balances[].fullContent	string	The full balance post
balances[].imagePath	string	The cover image of the balance post