Conta
Conta
Obtém os detalhes da tua conta API, incluindo saldo, configurações de overage e informações das subscrições de cada produto com contadores de uso.
Endpoint
Este endpoint retorna os detalhes da conta para a API key autenticada, incluindo o saldo restante, a configuração de overage e o estado das subscrições por produto com o uso acumulado no ciclo atual.
GET /v2/account
Autenticação
Inclui a tua API key no header x-api-key.
x-api-key: YourSecretAPIKey
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
balance | number | Saldo pré-pago restante na conta, em créditos. |
overageEnabled | boolean | Se a cobrança por overage está ativada nesta conta. |
overageSpendingLimit | number | Valor máximo de overage que a conta pode acumular neste ciclo, em créditos. 0 significa sem limite definido. |
subscriptions | object | Mapa de chave de produto para objeto de subscrição. Vê os campos abaixo. |
Campos de cada subscrição (cada valor dentro de subscriptions):
| Campo | Tipo | Descrição |
|---|---|---|
planId | string | Identificador do plano (por exemplo steam-full, endpoint-2.5m, thirdparty-none). |
startDate | string (ISO 8601) | Quando o plano atual começou. |
endDate | string (ISO 8601) | Quando o termo do plano atual termina. |
status | string | Estado da subscrição (por exemplo active). |
autoRenew | boolean | Se a subscrição renova automaticamente em nextRenewalDate. |
pendingPlanId | string | null | Plano para o qual a subscrição vai mudar no próximo ciclo, se houver. |
pendingChangeType | string | null | Tipo de alteração pendente (upgrade, downgrade) ou null. |
cycleStartDate | string (ISO 8601) | Início do ciclo de faturação atual. |
nextRenewalDate | string (ISO 8601) | Próxima data de renovação agendada. |
usage | object | Mapa de caminho do endpoint ou categoria de uso para o número de requests consumidos neste ciclo. |
billedOverage | number | Valor de overage já faturado neste ciclo, em créditos. |
Produtos e planos de subscrição
O objeto subscriptions é indexado por categoria de produto. Cada produto tem o seu conjunto de planos; os valores de planId são válidos apenas dentro da sua categoria de produto.
STEAM_DATA
Quota base de dados Steam (perfis, inventários, apps, items).
| Plan ID | Preço | Intervalo |
|---|---|---|
steam-none | Grátis | month |
steam-30days | €4.99 | month |
steam-180days | €19.99 | month |
steam-full | €29.99 | month |
EXTRA_REQUESTS
Quota adicional de requests para além do plano base. Preço mensal com overage cobrado por request.
| Plan ID | Máximo de requests | Preço | Intervalo |
|---|---|---|---|
endpoint-none | 500 | Grátis | por request |
endpoint-100k | 100.000 | €9.99 | month |
endpoint-250k | 250.000 | €24.99 | month |
endpoint-500k | 500.000 | €44.99 | month |
endpoint-1m | 1.000.000 | €89.99 | month |
endpoint-2.5m | 2.500.000 | €189.99 | month |
endpoint-10m | 10.000.000 | €599.99 | month |
endpoint-40m | 40.000.000 | €1.799,99 | month |
THIRD_PARTY_MARKET_DATA
Acesso a dados de marketplaces de terceiros.
| Plan ID | Preço | Intervalo |
|---|---|---|
thirdparty-none | Grátis | month |
thirdparty-data | €49.99 | month |
thirdparty-data-history-15 | €54.99 | month |
thirdparty-data-history-30 | €69.99 | month |
thirdparty-data-history-180 | €99.99 | month |
THIRD_PARTY_ADDON_SALES
Add-on de dados de vendas de terceiros.
| Plan ID | Preço | Intervalo |
|---|---|---|
addons-sales | €49.99 | month |
THIRD_PARTY_ADDON_WSS
Add-on de WebSocket stream de terceiros.
| Plan ID | Preço | Intervalo |
|---|---|---|
addons-wss | €39.99 | month |
Os plan IDs e preços podem mudar com o tempo. Trata o planId como um identificador opaco no contexto da sua categoria de produto.
Exemplo de resposta
response.json
{
"success": true,
"result": {
"balance": 493177.0881900459,
"overageEnabled": true,
"overageSpendingLimit": 0,
"subscriptions": {
"STEAM_DATA": {
"planId": "steam-full",
"startDate": "2026-01-19T03:35:35.815Z",
"endDate": "2026-05-19T03:35:35.815Z",
"status": "active",
"autoRenew": true,
"pendingPlanId": null,
"pendingChangeType": null,
"cycleStartDate": "2026-01-19T03:35:35.815Z",
"nextRenewalDate": "2026-05-19T03:35:35.815Z",
"usage": {
"steam/inventory": 122935,
"steam/profile": 83223,
"market/items": 276,
"market/item": 20928,
"/v2/steam/users/:steamid": 5,
"/v2/steam/apps/:appId": 5
},
"billedOverage": 0
},
"EXTRA_REQUESTS": {
"planId": "endpoint-2.5m",
"startDate": "2026-01-19T03:35:36.067Z",
"endDate": "2026-05-19T03:35:35.815Z",
"status": "active",
"autoRenew": true,
"pendingPlanId": null,
"pendingChangeType": null,
"cycleStartDate": "2026-01-19T03:35:35.815Z",
"nextRenewalDate": "2026-05-19T03:35:35.815Z",
"usage": {
"steam/profile": 83223,
"steam/inventory": 122476,
"market/item": 20928,
"/v2/steam/apps": 1,
"/v2/steam/users/:steamid/friends": 1
},
"billedOverage": 0
},
"THIRD_PARTY_MARKET_DATA": {
"planId": "thirdparty-none",
"startDate": "2026-01-19T03:38:43.170Z",
"endDate": "2026-05-19T03:35:35.815Z",
"status": "active",
"autoRenew": true,
"pendingPlanId": null,
"pendingChangeType": null,
"cycleStartDate": "2026-01-19T03:35:35.815Z",
"nextRenewalDate": "2026-05-19T03:35:35.815Z",
"usage": {
"market/items": 276,
"market/item": 20928
},
"billedOverage": 0
}
}
}
}