STABLECOIN INFRASTRUCTURE FOR DEVELOPERS

Stablecoin API for Pix on-ramps, off-ramps and wallets

Connect BRL payments and digital assets through a REST API. Evaluate the objects, signing requirements, pricing and test environment before integrating Hodle into your fintech.

USDTUSDT
USDCUSDC
PixPix

What a stablecoin API does

A stablecoin API lets software request quotes, connect fiat payments to digital assets and track transfers. Hodle connects Brazil’s Pix to on-ramp and off-ramp flows and wallets. This overview helps you evaluate the integration; the Brazil Pix guide covers the payment flows in detail.

Core objects: quote, pay-in, payout, wallet and webhook

Think of these as integration concepts; the endpoint reference defines the request and response fields.

ObjectRole in your integration
QuotePOST /api/quote returns indicative pricing without payment execution or a locked rate.
Pay-inPOST /api/deposit/asset starts the on-ramp flow for an available asset and network.
PayoutPOST /api/wallet/payout starts a stablecoin-funded Pix payout; track its transactionId and status.
WalletIn the PIN-based flow, supply walletPin and protectedSymmetricKey for the selected source wallet. An API key alone does not authorize signing.
WebhookAn event used to reconcile operation state. Verify signatures and deduplicate before updating orders or balances.

Idempotency and webhooks

Build idempotent processing around persisted operation identifiers and deduplicated events. An accepted request is not settlement confirmation. If a submission times out, resolve the existing operation before submitting another payment. Verify webhook signatures and check the expected final state before releasing an order. Consult the endpoint documentation for retry semantics rather than assuming a universal idempotency header.

Supported assets and networks

The published asset list includes the networks below. Availability is specific to the asset, account and operation: this is not a promise that every endpoint supports every listed network. Documented Pix payout examples include USDT on Polygon or Tron and USDC on Base.

StablecoinPublished networks; confirm support for your flow
USDTPolygon, Base, Solana, Tron, Arbitrum, Spark
USDCBase, Polygon, Solana, Arbitrum, Spark

Stablecoin API pricing

API payouts have their own pricing, which can vary by account, asset, network and enabled flow. Check the fee and total debit in the beneficiary-linked quote. When executed with quoteId, the payout uses that quote’s conditions. The commercial schedule below applies only to operations covered by a proposal or contract adopting it; its BRL 0.75 minimum does not automatically apply to API payouts.

Monthly volume (BRL)Commercial service fee
Up to 100,0002.00%
Above 100,000 to 300,0001.60%
Above 300,000 to 800,0001.25%
Above 800,000 to 2 million0.95%
Above 2 million to 5 million0.70%
Above 5 million0.50%

Sandbox quickstart: request a quote

Create a separate account at app-sandbox.hodle.com.br and issue a test key. Set HODLE_SANDBOX_API_KEY on your backend, then run this curl request for BRL 100 into USDC via Base. A quote is indicative: it does not execute a payment or lock a rate. Supported sandbox operations use Base Sepolia test tokens and simulate Pix; sandbox rates are not production prices.

cURL · sandbox quote · no payment executionbash
curl --request POST \
  --url https://sandbox-api.hodle.com.br/api/quote \
  --header "Authorization: Bearer $HODLE_SANDBOX_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "inputCurrency": "BRL",
    "inputPaymentMethod": "PIX",
    "outputCurrency": "USDC",
    "outputPaymentMethod": "BASE",
    "inputAmount": "100.00"
  }'

Evaluate production access and wallet authorization

Hodle supplies software and API infrastructure. Production requires applicable individual or business verification and flow enablement. In the PIN-based API flow, the server temporarily unlocks the selected wallet key in memory to sign; your platform must protect wallet and subaccount credentials. Sandbox access does not approve production access.

Frequently asked questions

Practical questions before integrating.

What is a stablecoin API?

A stablecoin API is an interface for software to request quotes, connect payments to stablecoins and track operations. Hodle offers Pix on-ramp and off-ramp flows and wallet infrastructure for Brazil.

How do I choose a stablecoin API?

Check the exact asset, network and payment flow, wallet signing model, verification requirements, quote and fee breakdown, event handling and sandbox coverage. Test pending states and unknown submission results before production.

How much does a stablecoin API cost?

Hodle publishes a commercial volume schedule from 2% to 0.5%, with a BRL 0.75 minimum, for covered operations. API payouts have their own pricing; confirm your account terms and the beneficiary-linked quote rather than applying the commercial table to every endpoint.

Can I convert USDT to BRL by API?

Yes. Hodle supports stablecoin-funded Pix payouts, with documented USDT examples on Polygon and Tron. Availability depends on your account, verification and enabled flow. Confirm the beneficiary and quote before execution.

Is there a sandbox?

Yes. Register separately at app-sandbox.hodle.com.br and issue a test key. Supported operations use Base Sepolia test tokens and simulate Pix without moving reais. Production access requires separate approval.

Does a quote execute a stablecoin payment?

No. POST /api/quote returns indicative pricing without executing a payment or locking a rate. Follow the documented flow for beneficiary confirmation, authorization, execution and status tracking.

Ready to integrate?

Test with a separate sandbox account before applying for production verification and flow permissions.