# VALORANT API > VALORANT game content as an API, powered by valorant-api.com. Get every playable agent with their role, abilities and lore, all maps with their callouts and coordinates, the full weapon roster with costs, fire rate, magazine size and head/body/leg damage (plus the list of skins per gun), the current competitive rank tiers from Iron to Radiant with their colours, and all playable game modes. Look up a single agent, map or weapon by name, or filter agents by role (Duelist, Initiator, Controller, Sentinel) and weapons by category. Game data is served from a static CDN, so it is fast and rock-solid under load. Perfect for VALORANT companion apps, agent and weapon guides, rank trackers, Discord bots, tier lists and fan sites. No accounts, no upstream key. Not affiliated with Riot Games. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/valorant-api/..." ``` ## Pricing - **Free** (Free) — 3,450 calls/Mo, 2 req/s - **Starter** ($5/Mo) — 44,500 calls/Mo, 5 req/s - **Pro** ($15/Mo) — 212,000 calls/Mo, 15 req/s - **Mega** ($40/Mo) — 1,075,000 calls/Mo, 40 req/s ## Endpoints ### Agents #### `GET /v1/agents` — Agents (all, by name, or by role) **Parameters:** - `name` (query, optional, string) — Agent name Example: `Jett` - `role` (query, optional, string) — Duelist|Initiator|Controller|Sentinel Example: `Duelist` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/valorant-api/v1/agents?name=Jett&role=Duelist" ``` **Response:** ```json { "data": { "agent": { "icon": "https://media.valorant-api.com/agents/add6443a-41bd-e414-f6ad-e58d267f4e95/displayicon.png", "name": "Jett", "role": "Duelist", "uuid": "add6443a-41bd-e414-f6ad-e58d267f4e95", "portrait": "https://media.valorant-api.com/agents/add6443a-41bd-e414-f6ad-e58d267f4e95/fullportrait.png", "abilities": [ { "name": "Updraft", "slot": "Ability1", "description": "INSTANTLY propel Jett high into the air." }, { "name": "Tailwind", "slot": "Ability2", "description": "ACTIVATE to prepare a gust of wind for a limited time. RE-USE the wind to propel Jett in the direction she is moving. If Jett is standing still, she propels forward. Tailwind charge resets every two kills." }, { "name": "Cloudburst", "slot": "Grenade", "description": "INSTANTLY throw a projectile that expands into a brief vision-blocking cloud on impact with a surface. HOLD the ability key to curve the smoke in the direction of your crosshair." }, { "name": "Blade Storm", "slot": "Ultimate", "description": "EQUIP a set of highly accurate throwing knives. FIRE to throw …(truncated, see openapi.json for full schema) ``` ### Maps #### `GET /v1/maps` — Maps (all or by name) **Parameters:** - `name` (query, optional, string) — Map name Example: `Bind` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/valorant-api/v1/maps?name=Bind" ``` **Response:** ```json { "data": { "map": { "name": "Bind", "uuid": "2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba", "splash": "https://media.valorant-api.com/maps/2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba/splash.png", "minimap": "https://media.valorant-api.com/maps/2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba/displayicon.png", "callouts": 24, "list_icon": "https://media.valorant-api.com/maps/2c9d57ec-4431-9c5e-2939-8f9ef6dd5cba/listviewicon.png", "coordinates": "34°2'A'N,6°51'Z'W", "description": "A/B Sites" } }, "meta": { "timestamp": "2026-06-01T00:04:03.384Z", "request_id": "86d91756-0bf7-4d05-8416-a1d834c63af4" }, "status": "ok", "message": "Maps retrieved", "success": true } ``` ### Weapons #### `GET /v1/weapons` — Weapons (all, by name, or by category) **Parameters:** - `name` (query, optional, string) — Weapon name Example: `Vandal` - `category` (query, optional, string) — Category filter Example: `Rifle` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/valorant-api/v1/weapons?name=Vandal&category=Rifle" ``` **Response:** ```json { "data": { "weapon": { "cost": 2900, "icon": "https://media.valorant-api.com/weapons/9c82e19d-4575-0200-1a81-3eacf00cf872/displayicon.png", "name": "Vandal", "uuid": "9c82e19d-4575-0200-1a81-3eacf00cf872", "skins": [ "Immortalized Vandal", "RGX 11z Pro Vandal", "Altitude Vandal", "VALORANT GO! Vol. 2 Vandal", "Divergence Vandal", "Araxys Vandal", "Neptune Vandal", "Aristocrat Vandal", "Gaia's Vengeance Vandal", "MK.VII Liberty Vandal", "Endeavour Vandal", "ATLAS // CMD Vandal", "Champions 2021 Vandal", "Champions 2023 Vandal", "Origin Vandal", "Comet Vandal", "Phaseguard Vandal", "Starlit Odyssey Vandal", "Glitchpop Vandal", "ChronoVoid Vandal", "Prelude to Chaos Vandal", "Elderflame Vandal", "Imperium Vandal", "Singularity Vandal", "ORA by OneTap Vandal", "Sarmad Vandal", "Nitro Vandal", "Hivemind Vandal", "Venturi Vandal", "Forsaken Vandal", "Team Ace Vandal", "Heartstopper Vandal", " …(truncated, see openapi.json for full schema) ``` ### Reference #### `GET /v1/gamemodes` — Playable game modes **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/valorant-api/v1/gamemodes" ``` **Response:** ```json { "data": { "count": 16, "gamemodes": [ { "icon": "https://media.valorant-api.com/gamemodes/1cd8901f-47af-49cb-d758-e2afd0eb2a39/displayicon.png", "name": "All Random One Site", "uuid": "1cd8901f-47af-49cb-d758-e2afd0eb2a39", "duration": "10-15 MINS", "description": "LIMITED TIME: Plant/defuse mode. One site, random agents, free loadouts, way more ultimates. First to 5 wins.", "allows_timeouts": false }, { "icon": "https://media.valorant-api.com/gamemodes/96bd3920-4f36-d026-2b28-c683eb0bcac5/displayicon.png", "name": "Standard", "uuid": "96bd3920-4f36-d026-2b28-c683eb0bcac5", "duration": "30-40 MINS", "description": "Plant/defuse mode. Unranked matches, full map pool, attack and defend, classic gameplay. First to 13 wins.", "allows_timeouts": true }, { "icon": "https://media.valorant-api.com/gamemodes/a8790ec5-4237-f2f0-e93b-08a8e89865b2/displayicon.png", "name": "Deathmatch", "uuid": "a8790ec5-4237-f2f0-e93b-08a8e89865b2", "duration": "7-9 MINS", "description": "Elimination mode. All gunplay, respawn instantly, no abilities, no economy. First to 40 kills wins.", "allows_timeouts": false }, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/tiers` — Competitive rank tiers **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/valorant-api/v1/tiers" ``` **Response:** ```json { "data": { "count": 25, "tiers": [ { "icon": "https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/3/largeicon.png", "name": "IRON 1", "tier": 3, "color": "4f514fff", "division": "IRON" }, { "icon": "https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/4/largeicon.png", "name": "IRON 2", "tier": 4, "color": "4f514fff", "division": "IRON" }, { "icon": "https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/5/largeicon.png", "name": "IRON 3", "tier": 5, "color": "4f514fff", "division": "IRON" }, { "icon": "https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/6/largeicon.png", "name": "BRONZE 1", "tier": 6, "color": "a5855dff", "division": "BRONZE" }, { "icon": "https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/7/largeicon.png", "name": "BRONZE 2", "tier": 7, "color": "a5855dff", "division": "BRONZE" …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Usage notes **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/valorant-api/v1/meta" ``` **Response:** ```json { "data": { "note": "VALORANT game content. /v1/agents (all playable agents; ?name=Jett for one with abilities & lore; ?role=Duelist|Initiator|Controller|Sentinel to filter); /v1/maps (?name=Bind for one — callouts, coordinates, splash); /v1/weapons (?name=Vandal for one with its skins; ?category=Rifle to filter — cost, fire rate, magazine, head/body/leg damage); /v1/tiers (current competitive ranks Iron→Radiant with colors); /v1/gamemodes (playable modes). Game data from valorant-api.com. Not affiliated with Riot Games.", "source": "valorant-api.com (community VALORANT game-data API)", "endpoints": [ "/v1/agents", "/v1/maps", "/v1/weapons", "/v1/tiers", "/v1/gamemodes", "/v1/meta" ] }, "meta": { "timestamp": "2026-06-01T00:04:03.763Z", "request_id": "f0e43380-1e8b-47b1-8555-defc55e6f22a" }, "status": "ok", "message": "Meta retrieved", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/valorant-api OpenAPI spec: https://www.oanor.com/api/valorant-api/openapi.json