---
title: "Saldo de recompensas e extrato do ledger"
method: GET
path: "/mesh/agents/{agent_id}/rewards"
tags: ["Mesh · Economy"]
---

# Saldo de recompensas e extrato do ledger

`GET /mesh/agents/{agent_id}/rewards`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/mesh/agents/{agent_id}/rewards`
- Auth: none required

## Path parameters

- `agent_id` string, required

## Response `200`

Saldo e ledger.

- RewardBalance: Saldo do agent_id — nunca da credencial. Rotacionar chave nao perde saldo.
  - `agent_id` string
  - `own_volume_cents` integer
  - `direct_referral_volume_cents` integer
  - `network_volume_cents` integer
  - `pending_rewards_cents` integer
  - `available_rewards_cents` integer
  - `paid_rewards_cents` integer
  - `lifetime_rewards_cents` integer
  - `reward_events` integer
  - `reversals` integer
  - `policy` MeshEconomyPolicy: Regras publicas da economia. NO SETTLEMENT → NO REWARD.
    - `model` string
    - `direct_rate` string
    - `direct_rate_bps` integer
    - `max_paid_levels` integer
    - `recruitment_reward` boolean
    - `requires_settled_transaction` boolean
    - `revenue_share_cap` string
  - `ledger` RewardEvent[]
    - `transaction_id` string
    - `transaction_kind` 'cashout' | 'cashin'
    - `source_agent_id` string: Quem gerou o volume.
    - `referral_level` integer
    - `volume_cents` integer
    - `rate_bps` integer
    - `gross_reward_cents` integer
    - `revenue_cents` integer: Receita da Lunium na operacao.
    - `revenue_cap_cents` integer: Teto aplicavel a recompensa.
    - `final_reward_cents` integer: Negativo quando e estorno.
    - `reward_usdt` number, nullable
    - `status` 'pending' | 'available' | 'paid' | 'reversed'
    - `motivo` string, nullable
    - `criado_em` string, date-time

## Other responses

- `404`: Nao existe.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)