Docs menu
VLR API endpoint
VLR.gg match economy API
Returns the Economy tab of one VLR.gg match for every map and for the whole match: each team's pistol rounds, pistol conversion and bonus-round records, win records by buy level (`eco` under 10k, `half` 10k to 18k, `full` 18k and over) against each opponent buy level, and round by round banks, loadout values, buy levels, the winner and the winning side. `available` is false while VLR has not published the tab, which is normal for a match that just ended.
GETapiKey2 credits/requestVLR
VLR/vlr/match-economyEndpoint facts
- Method
- GET
- API path
- /vlr/match-economy
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- VLR
How this endpoint behaves
Returns a VLR.gg match's economy statistics per map: pistol, bonus and buy-level records plus round by round banks and loadouts.
Header: x-api-key required.
Parameters:
id: required numeric VLR match id from vlr-matches, vlr-results or vlr-event-matches.
Notable response behavior:
pistol_rounds,pistol_conversionandbonus_roundsarewonofplayed.buy_buckets[].buyhas these values:eco,half,full;vs_eco,vs_halfandvs_fullgive the team's record against each opponent buy level and are omitted where there were no such rounds.- Rounds carry
team1_*andteam2_*in the order ofteams. Banks and loadouts are in thousands of credits.team1_buyandteam2_buyhave these values:eco,half,full, derived from the loadout with the same thresholds VLR prints.winner_sidehas these values:attack,defense. availableis false (andmapsempty) while VLR shows "Stats from this match are not available yet". An unknown match id returns404.- The response is cached for up to ten minutes.
Sampled response
- Request, 29 Oct 2026
- GET /vlr/match-economy?id=754737
- Items in maps
- 4
- Fields filled in every checked item
- 6
| Field | Filled in, of 4 checked | Values in the sample |
|---|---|---|
| game_id | 4 | |
| map_number | 4 | 1 to 4, median 2 |
| map | 4 | “Summit” and 3 other values |
| teams | 4 | median 2 entries |
| buy_buckets | 4 | median 3 entries |
| rounds | 4 | median 25 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| id | string | Yes | Numeric VLR match id from vlr-matches, vlr-results or vlr-event-matches | 754737 |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/vlr/match-economy?id=754737" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.vlr.gg/match/tab/economy",
"fetched_at": "2026-10-28T10:00:00Z",
"id": "754737",
"available": true,
"maps": [
{
"game_id": "283286",
"map_number": 1,
"map": "Summit",
"teams": [
{
"team": "LOUD",
"pistol_rounds": {
"won": 1,
"played": 2
},
"pistol_conversion": {
"won": 1,
"played": 1
},
"bonus_rounds": {
"won": 0,
"played": 1
}
}
],
"buy_buckets": [
{
"buy": "full",
"label": "On Full buy18k+",
"teams": [
{
"team": "LOUD",
"vs_full": {
"won": 7,
"played": 12
}
}
]
}
],
"rounds": [
{
"round": 1,
"pistol": true,
"team1_bank_k": 0.1,
"team2_bank_k": 0.1,
"team1_loadout_k": 3.9,
"team2_loadout_k": 4,
"team1_buy": "eco",
"team2_buy": "eco",
"winner_team": "VIT",
"winner_side": "defense"
}
]
}
]
}
}Request schema
No body schema
Response schema
Inline response schema
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | vlr.MatchEconomy | No | ||||
| data.all_maps | vlr.EconomyBlock | No | ||||
| data.all_maps.buy_buckets | array | No | ||||
| data.all_maps.buy_buckets[].buy | string | No | eco, half, full | eco | ||
| data.all_maps.buy_buckets[].label | string | No | On Eco <10k | |||
| data.all_maps.buy_buckets[].teams | array | No | ||||
| data.all_maps.buy_buckets[].teams[].team | string | No | LOUD | |||
| data.all_maps.buy_buckets[].teams[].vs_eco | vlr.Ratio | No | ||||
| data.all_maps.buy_buckets[].teams[].vs_eco.played | integer | No | 8 | |||
| data.all_maps.buy_buckets[].teams[].vs_eco.won | integer | No | 3 | |||
| data.all_maps.buy_buckets[].teams[].vs_full | vlr.Ratio | No | ||||
| data.all_maps.buy_buckets[].teams[].vs_full.played | integer | No | 8 | |||
| data.all_maps.buy_buckets[].teams[].vs_full.won | integer | No | 3 | |||
| data.all_maps.buy_buckets[].teams[].vs_half | vlr.Ratio | No | ||||
| data.all_maps.buy_buckets[].teams[].vs_half.played | integer | No | 8 | |||
| data.all_maps.buy_buckets[].teams[].vs_half.won | integer | No | 3 | |||
| data.all_maps.game_id | string | No | 283286 | |||
| data.all_maps.map | string | No | Bind | |||
| data.all_maps.map_number | integer | No | 1 | |||
| data.all_maps.rounds | array | No | ||||
| data.all_maps.rounds[].pistol | boolean | No | true | |||
| data.all_maps.rounds[].round | integer | No | 1 | |||
| data.all_maps.rounds[].team1_bank_k | number | No | 0.1 | |||
| data.all_maps.rounds[].team1_buy | string | No | eco, half, full | eco | ||
| data.all_maps.rounds[].team1_loadout_k | number | No | 3.9 | |||
| data.all_maps.rounds[].team2_bank_k | number | No | 0.1 | |||
| data.all_maps.rounds[].team2_buy | string | No | eco, half, full | eco | ||
| data.all_maps.rounds[].team2_loadout_k | number | No | 4 | |||
| data.all_maps.rounds[].winner_side | string | No | attack, defense | defense | ||
| data.all_maps.rounds[].winner_team | string | No | VIT | |||
| data.all_maps.teams | array | No | ||||
| data.all_maps.teams[].bonus_rounds | vlr.Ratio | No | ||||
| data.all_maps.teams[].bonus_rounds.played | integer | No | 8 | |||
| data.all_maps.teams[].bonus_rounds.won | integer | No | 3 | |||
| data.all_maps.teams[].pistol_conversion | vlr.Ratio | No | ||||
| data.all_maps.teams[].pistol_conversion.played | integer | No | 8 | |||
| data.all_maps.teams[].pistol_conversion.won | integer | No | 3 | |||
| data.all_maps.teams[].pistol_rounds | vlr.Ratio | No | ||||
| data.all_maps.teams[].pistol_rounds.played | integer | No | 8 | |||
| data.all_maps.teams[].pistol_rounds.won | integer | No | 3 | |||
| data.all_maps.teams[].team | string | No | LOUD | |||
| data.available | boolean | No | true | |||
| data.fetched_at | string | No | 2026-10-27T10:00:00Z | |||
| data.id | string | No | 754737 | |||
| data.maps | array | No | ||||
| data.maps[].buy_buckets | array | No | ||||
| data.maps[].buy_buckets[].buy | string | No | eco, half, full | eco | ||
| data.maps[].buy_buckets[].label | string | No | On Eco <10k | |||
| data.maps[].buy_buckets[].teams | array | No | ||||
| data.maps[].buy_buckets[].teams[].team | string | No | LOUD | |||
| data.maps[].buy_buckets[].teams[].vs_eco | vlr.Ratio | No | ||||
| data.maps[].buy_buckets[].teams[].vs_eco.played | integer | No | 8 | |||
| data.maps[].buy_buckets[].teams[].vs_eco.won | integer | No | 3 | |||
| data.maps[].buy_buckets[].teams[].vs_full | vlr.Ratio | No | ||||
| data.maps[].buy_buckets[].teams[].vs_full.played | integer | No | 8 | |||
| data.maps[].buy_buckets[].teams[].vs_full.won | integer | No | 3 | |||
| data.maps[].buy_buckets[].teams[].vs_half | vlr.Ratio | No | ||||
| data.maps[].buy_buckets[].teams[].vs_half.played | integer | No | 8 | |||
| data.maps[].buy_buckets[].teams[].vs_half.won | integer | No | 3 | |||
| data.maps[].game_id | string | No | 283286 | |||
| data.maps[].map | string | No | Bind | |||
| data.maps[].map_number | integer | No | 1 | |||
| data.maps[].rounds | array | No | ||||
| data.maps[].rounds[].pistol | boolean | No | true | |||
| data.maps[].rounds[].round | integer | No | 1 | |||
| data.maps[].rounds[].team1_bank_k | number | No | 0.1 | |||
| data.maps[].rounds[].team1_buy | string | No | eco, half, full | eco | ||
| data.maps[].rounds[].team1_loadout_k | number | No | 3.9 | |||
| data.maps[].rounds[].team2_bank_k | number | No | 0.1 | |||
| data.maps[].rounds[].team2_buy | string | No | eco, half, full | eco | ||
| data.maps[].rounds[].team2_loadout_k | number | No | 4 | |||
| data.maps[].rounds[].winner_side | string | No | attack, defense | defense | ||
| data.maps[].rounds[].winner_team | string | No | VIT | |||
| data.maps[].teams | array | No | ||||
| data.maps[].teams[].bonus_rounds | vlr.Ratio | No | ||||
| data.maps[].teams[].bonus_rounds.played | integer | No | 8 | |||
| data.maps[].teams[].bonus_rounds.won | integer | No | 3 | |||
| data.maps[].teams[].pistol_conversion | vlr.Ratio | No | ||||
| data.maps[].teams[].pistol_conversion.played | integer | No | 8 | |||
| data.maps[].teams[].pistol_conversion.won | integer | No | 3 | |||
| data.maps[].teams[].pistol_rounds | vlr.Ratio | No | ||||
| data.maps[].teams[].pistol_rounds.played | integer | No | 8 | |||
| data.maps[].teams[].pistol_rounds.won | integer | No | 3 | |||
| data.maps[].teams[].team | string | No | LOUD | |||
| data.source_url | string | No | https://www.vlr.gg/matches | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/vlr/match-economy?id=754737" \
-H "x-api-key: $CRAWLORA_API_KEY"