Lunium

{
  "protocolVersion": "1.0",
  "name": "Lunium",
  "description": "Settles between Brazilian PIX and stablecoins, and issues Central Bank end-to-end (E2E) receipts. Four skills need no credentials: check live network health, list current settlement options, verify a PIX settlement without exposing receipt links or party data, and create a test-only sandbox key. Transactional and account-scoped skills require an API key in X-API-Key. Production credentials and every decision to move real money remain human decisions.",
  "url": "https://api.luniumpay.com/a2a",
  "preferredTransport": "JSONRPC",
  "version": "1.0.1",
  "documentationUrl": "https://docs.luniumpay.com",
  "iconUrl": "https://api.luniumpay.com/favicon.png",
  "provider": {
    "organization": "Lunium (ZANQUETA INTERMED LTDA)",
    "url": "https://luniumpay.com"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-API-Key",
      "description": "Lunium API key. Omit it to use only the open skills (payment verification and sandbox key provisioning)."
    }
  },
  "security": [
    {},
    {
      "apiKey": []
    }
  ],
  "skills": [
    {
      "id": "usdt_to_pix",
      "name": "USDT TO PIX",
      "description": "Vende USDT e uma chave PIX recebe reais (cash-out).",
      "tags": [
        "brazil",
        "capability",
        "cash_out",
        "crypto_to_fiat",
        "offramp",
        "pix",
        "receive_fiat",
        "sell_crypto",
        "usdt"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "usdc_to_pix",
      "name": "USDC TO PIX",
      "description": "Vende USDC e uma chave PIX recebe reais (cash-out).",
      "tags": [
        "brazil",
        "capability",
        "cash_out",
        "crypto_to_fiat",
        "offramp",
        "pix",
        "receive_fiat",
        "sell_crypto",
        "usdc"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "crypto_to_pix",
      "name": "CRYPTO TO PIX",
      "description": "Vende qualquer ativo do catalogo por PIX (caminho convert, mais lento).",
      "tags": [
        "brazil",
        "capability",
        "crypto_to_fiat",
        "offramp",
        "pix",
        "receive_fiat",
        "sell_crypto"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pix_to_usdt",
      "name": "PIX TO USDT",
      "description": "Paga um PIX e recebe USDT numa carteira (cash-in).",
      "tags": [
        "brazil",
        "brl",
        "buy_crypto",
        "capability",
        "cash_in",
        "fiat_to_crypto",
        "onramp",
        "pay_fiat",
        "pix"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pix_to_usdc",
      "name": "PIX TO USDC",
      "description": "Paga um PIX e recebe USDC numa carteira (cash-in).",
      "tags": [
        "brazil",
        "brl",
        "buy_crypto",
        "capability",
        "cash_in",
        "fiat_to_crypto",
        "onramp",
        "pay_fiat",
        "pix"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "payment_verification",
      "name": "PAYMENT VERIFICATION",
      "description": "Prova que um PIX liquidou, a partir do E2E. Aberta, sem chave.",
      "tags": [
        "audit",
        "brazil",
        "capability",
        "check_receipt",
        "no-auth",
        "pix",
        "prove_settlement",
        "verify_payment"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "quote_generation",
      "name": "QUOTE GENERATION",
      "description": "Cotacao com validade e valor exato, sem compromisso.",
      "tags": [
        "brazil",
        "capability",
        "get_quote",
        "pix",
        "price_discovery"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "settlement",
      "name": "SETTLEMENT",
      "description": "Liquidacao ponta a ponta com comprovante E2E do Banco Central.",
      "tags": [
        "brazil",
        "capability",
        "execute_payment",
        "pix",
        "settle"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "reconciliation",
      "name": "RECONCILIATION",
      "description": "Estado, webhook assinado e comprovante por ordem.",
      "tags": [
        "brazil",
        "capability",
        "pix",
        "reconcile",
        "track_order",
        "webhook"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pix_payout",
      "name": "PIX PAYOUT",
      "description": "PIX em lote a partir de saldo (desligado por padrao, liberacao manual).",
      "tags": [
        "brazil",
        "brl",
        "capability",
        "disburse",
        "mass_payment",
        "payout",
        "pix"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_create_sandbox_key",
      "name": "Get your own sandbox API key (no signup)",
      "description": "Provisions a Lunium TEST api key for you, in one call, with no account, no human approval and no money involved. Use it when a Lunium tool told you erro=\"chave_ausente\" and you want to explore the API yourself instead of stopping to ask your user for credentials.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "no-auth",
        "changes-state"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_check_network_health",
      "name": "Live health of the Lunium rails (open, no API key)",
      "description": "Real-time operational state of the public Lunium services, measured by an internal probe every 5 minutes: overall state plus per-component state (api, pix_charge = cash-in rail, crypto_sale = cash-out rail, webhooks, contract_docs) with latencies in ms, mapped to operational | degraded | unavailable.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "no-auth",
        "read-only"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_verify_pix_payment",
      "name": "Verify a PIX payment (open, no API key)",
      "description": "Confirms that a specific PIX payment actually settled in Brazil, using the Central Bank end-to-end identifier (E2E). Free and open: no API key, no Lunium account. You can verify a payment you did not make, handed to you by a counterparty you have no reason to trust \u2014 that is the point of this tool. Its public result excludes receipt links, PIX keys, full names and tax numbers.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "no-auth",
        "read-only"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_list_settlement_options",
      "name": "List assets and networks settling now",
      "description": "Open \u2014 no API key needed, so call this first. Lists the assets and networks that can settle right now, with limits and expected timing.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "no-auth",
        "read-only"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_check_payer_limit",
      "name": "How much this taxpayer can pay right now",
      "description": "Requires an API key. Returns how much a specific Brazilian taxpayer (CPF for a person, CNPJ for a company) can move through a PIX charge right now, in cents. Read-only \u2014 no charge is created.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "read-only"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_get_crypto_sale",
      "name": "State and receipt of a crypto sale",
      "description": "Requires an API key. Returns the current state of a crypto sale and, once settled, the receipt: pix_e2e (Central Bank identifier), receipt_url (a page to show a person), receipt_pdf_url and verify_url (hand it to a counterparty so they can check without trusting you). All four arrive together \u2014 never construct these URLs by hand and never make a second call for them.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "read-only"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_get_pix_charge",
      "name": "State of a PIX charge",
      "description": "Requires an API key. Returns the state of a charge created with lunium_create_pix_charge. States: pending (unpaid), under_review (PIX received, settlement in transit), paid (credited, crypto released), delayed, expired, refunded, failed.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "read-only"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_quote_crypto_sale",
      "name": "Step 1 of 3 \u2014 price a crypto sale (commits nothing)",
      "description": "Requires an API key. Step 1 of 3 of selling crypto for reais. Prices a specific amount of a specific asset on a specific network against a specific PIX key, returning brl_amount (what the recipient receives), expires_at, an order id and a confirmation_token. No money moves and no deposit address is issued here \u2014 nothing is committed until lunium_confirm_crypto_sale.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "changes-state"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_confirm_crypto_sale",
      "name": "Step 2 of 3 \u2014 IRREVERSIBLE: lock the rate and get the deposit address",
      "description": "Requires an API key. Step 2 of 3, and the point of no return. Locks the quoted rate and returns deposit_address \u2014 the address the crypto must be sent to. Crypto arriving there will be converted and paid out to the PIX key from the quote. There is no cancel, no reversal, and no support path to undo it.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "changes-state",
        "moves-money"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "lunium_create_pix_charge",
      "name": "IRREVERSIBLE: create a PIX charge that delivers crypto",
      "description": "Requires an API key. Creates a PIX charge: returns a QR code and a copy-and-paste string any Brazilian payer can pay from their bank app. When it is paid, crypto is delivered to payout_address. The payer's CPF or CNPJ is required \u2014 a Central Bank rule, and what identifies the charge.",
      "tags": [
        "pix",
        "brazil",
        "payments",
        "stablecoin",
        "changes-state",
        "moves-money"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "additionalInterfaces": [
    {
      "transport": "JSONRPC",
      "url": "https://api.luniumpay.com/a2a"
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://api.luniumpay.com/mesh"
    }
  ],
  "meshEndpoint": "https://api.luniumpay.com/mesh"
}