---
title: "Limites vigentes e uso do dia"
method: GET
path: "/keys/me"
tags: ["Conta"]
---

# Limites vigentes e uso do dia

`GET /keys/me`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/keys/me`
- Auth: API key in header `X-API-Key`

É o número que nunca envelhece: leia os limites daqui em vez de fixá-los no código.

**Cash-out (venda de cripto):** R$ 6,00 a R$ 250.000,00 por transação, mais um teto diário de R$ 100.000,00 por CPF/CNPJ de quem RECEBE o PIX (por chave, quando a chave PIX não é um documento), que renova à meia-noite no horário de Brasília. O máximo efetivo é o MENOR dos dois e vem em `limits.max_brl_cents`; o teto por transação vem em `limits.max_brl_cents_por_transacao`. Não existe teto diário por chave de API na venda.

**Cash-in e payouts:** também não há teto diário por chave (desde 10/09/2026): `limits.daily_limit_cents` vem `null`, `limits.tier` vem `"Sem teto"`, `limits.available_today_cents` e `limits.next_tier` vêm `null` e `limits.daily_limit_applies_to` vem `[]`. Cada cobrança vai de R$ 1,00 a R$ 6.000,00 (mínimo efetivo em `limits.per_operation.cashin.min_brl_cents`) e passa pela régua do pagador (`GET /cashin/limits`). O único teto diário por chave possível é o que a própria chave define em `mandate.max_diario_cents`.

## Response `200`

Sua chave e limites.

- ChaveMe: Sua chave, limites vigentes e o que está liberado.
  - `key` object
    - `sandbox` boolean
    - `key_id` integer
    - `prefix` string
    - `name` string
    - `email` string, nullable: E-mail informado na criação da chave. Chave de teste exige e-mail desde 01/10/2026; null em chave antiga criada sem e-mail.
    - `cashin_enabled` boolean
    - `cashout_enabled` boolean
    - `payout_enabled` boolean
    - `settlement_address` string, nullable: Carteira padrão de liquidação (Polygon); null até ser configurada.
    - `chain` string, nullable
    - `fee_bps` integer
    - `rate_limit_per_minute` integer
    - `webhook_url` string, nullable: null até cadastrar (PATCH /keys/me) — sem ela não chega cashin.paid/settled/delayed.
    - `webhook_configured` boolean
    - `telegram_linked` boolean
    - `created_at` string, nullable
    - `partner_fee_bps` integer: SUB FEE do parceiro, em bps, POR CIMA de `fee_bps` (a taxa da Lunium). 100 = 1%. Quem paga é o usuário final; a parte da Lunium não muda. 0 = não usa. Configure em PATCH /keys/me.
    - `partner_cashout_fee_bps` integer: Sub fee do parceiro na venda (bps). 0 = nao usa.
    - `partner_saque_fee_bps` integer: Sub fee do parceiro na saida da custodia (bps). 0 = nao usa.
    - `partner_deposito_fee_bps` integer: Subfee exclusiva do depósito Pix em saldo BRL, em basis points (100 = 1%). Padrão 0, máximo 1000. Aplicada ao valor recebido após a taxa fixa Lunium, descontada antes do crédito no saldo. Independente de compra, venda e saque. Congelada na criação; comissão creditada somente após liberação e crédito concluído (paid/sent).
  - `limits` object: Limites e uso vigentes da chave, por operação e pagador. null em teto diário significa ausência daquele teto, não de todas as restrições. Mandate e limites por pessoa podem aplicar.
    - `cashin_min_por_rota` object: Minimo em reais por moeda e rede, ja com as taxas desta chave. O min_brl_cents do cash-in em per_operation e o piso da CONTA (o que a taxa fixa exige); o piso da REDE e maior e e ele que costuma recusar. Vale o maior dos dois.
      - `nota` string
      - `rotas` object[]
        - `asset` string
        - `network` string
        - `min_brl_cents` integer
  - `payout` object: enabled, via, unlocks_at_settled_volume_cents, settled_volume_cents, remaining_cents.
  - `monitor_url` string: Painel de acompanhamento da chave.
  - `telegram` object
  - `grupos_obrigatorios` object: Links dos grupos de status (aviso, parceiros, comunidade).
  - `comissao` object: Comissão acumulada pela sub fee (saldo do parceiro). Detalhe em GET /comissao.
    - `partner_fee_bps` integer
    - `max_partner_fee_bps` integer
    - `disponivel_cents` integer, nullable
    - `creditado_cents` integer
    - `estornado_cents` integer
    - `sacado_cents` integer
    - `operacoes` integer
    - `ultimo_credito_em` string, date-time, nullable
    - `moeda` string
    - `nota` string
    - `partner_cashout_fee_bps` integer
    - `partner_saque_fee_bps` integer
    - `partner_deposito_fee_bps` integer: Subfee exclusiva do depósito Pix em saldo BRL, em basis points (100 = 1%). Padrão 0, máximo 1000. Aplicada ao valor recebido após a taxa fixa Lunium, descontada antes do crédito no saldo. Independente de compra, venda e saque. Congelada na criação; comissão creditada somente após liberação e crédito concluído (paid/sent).

## Other responses

- `401`: X-API-Key ausente, desconhecida ou incorreta.

## Changes

- **2026-10-19** `fc06c3b824b1`: 2 info
  - added the optional property `comissao/partner_deposito_fee_bps` to the response with the `200` status
  - added the optional property `key/partner_deposito_fee_bps` to the response with the `200` status

[Operation history](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/changes/keys/me/get.md)

---

[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)