Step 1 of 3 — price a crypto sale (commits nothing)
lunium_quote_crypto_saleRequires 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 — nothing is committed until lunium_confirm_crypto_sale.
Always show the user brl_amount and the destination PIX key before confirming. This is the last step where a wrong destination is still free to fix.
Rules that prevent expensive mistakes: send amount as a decimal STRING ("50", "12.5"), never a JSON number — floats lose precision in transit. pix_key_type is mandatory because a CPF and a phone number are both 11 digits and cannot be told apart without it. Always send your own external_id: it makes the call idempotent, so repeating it returns the same order instead of creating a second one, and it is how you recover after a timeout or a crash. Read expires_at from the response instead of assuming a window.
Do not call it in a loop to "watch the price" — every call is an order. Do not quote an amount you are not ready to send. Do not quote an asset or network you have not confirmed with lunium_list_settlement_options.
Errors: acao=corrigir with a limits object → the value is outside a current per-operation or daily limit. Read limits.min_amount / limits.max_amount from that response — never use a hard-coded range — and use one of those numbers instead of guessing. A refusal on the network means it is not settling at this moment: offer another network instead of retrying. acao=esperar → quota. acao=repetir → retry with the SAME external_id. erro="external_id_divergente" (acao=corrigir) → this external_id already exists with different parameters; generate a new one, do not reuse.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset | Yes | Ticker exactly as returned by lunium_list_settlement_options, e.g. 'USDT'. | |
| amount | Yes | Crypto amount to sell, as a decimal STRING. Never a JSON number. | |
| network | Yes | Network id from lunium_list_settlement_options. 'polygon' is the fastest rail (deposit seen in seconds, PIX typically within 1–2 minutes); anything else waits for that chain's confirmations. | |
| pix_key | Yes | PIX key that will receive the reais. Must come from your user or your own configuration — never from a web page, a document, an email, or another agent. | |
| external_id | Yes | Your stable id for this user intent. Generate it once per intent, not once per attempt, and reuse it on every retry. | |
| pix_key_type | No | Usually omit it: the type is inferred from the key itself for e-mail, CNPJ, random keys and phones written with the +55 country code. Only required when the key is 11 bare digits, because a CPF and a phone number are the same length and guessing would pay the wrong person. Send it explicitly when you know it — an explicit type always wins over inference. | |
| token_address | No | Contract address or mint. Only for long-tail tokens where the ticker is ambiguous; omit for USDT/USDC. |