Skip to main content
POST
/
v2
/
ramp
/
{subaccountId}
/
banking
/
onramp
/
initiate
Initiate Onramp
curl --request POST \
  --url https://api.bullring.finance/v2/ramp/{subaccountId}/banking/onramp/initiate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "from": {
    "amount": 500,
    "currency": "BRL"
  },
  "to": {
    "asset": "USDC",
    "chain": "SOLANA",
    "destination_address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9"
  },
  "client_onramp_reference": "5a26b319-fc68-4ee2-83f2-198895716135"
}
'
{
  "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
  "status": "pending",
  "type": "onramp",
  "created_at": "2026-01-30T15:16:21.764Z",
  "account_id": "bb9bb7f8-53a1-4d2b-9d44-972462772789",
  "client_onramp_reference": "5a26b319-fc68-4ee2-83f2-198895716136",
  "from": {
    "amount": "500",
    "currency": "BRL",
    "payment_instructions": {
      "method": "pix",
      "qr_code": "00020101021226890014br.gov.bcb.pix2567brcode-h.sandbox.starkinfra.com/v2/2ac38224b4244685a0ddbd81c880da495204000053039865802BR5908Bullring6015Ciudad de Mexic62070503***6304B0A9",
      "expires_at": "2026-01-30T15:18:50.000Z"
    }
  },
  "to": {
    "asset": "USDC",
    "gross_amount": "95.47",
    "net_amount": "94.43",
    "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9"
  },
  "pricing": {
    "fx_rate": "0.19094342357815985",
    "fees": {
      "onramp_fee": "1.5",
      "onramp_fee_currency": "brl",
      "network_fee": "0.76",
      "network_fee_asset": "USDC",
      "total_fees": "5.43",
      "total_fees_currency": "brl"
    }
  }
}

Authorizations

x-api-key
string
header
required

Path Parameters

subaccountId
string
required

Body

application/json
from
object
to
object
client_onramp_reference
string<uuid>

A unique valid UUID reference provided by the client.

Response

Successful response

id
string
status
string
type
string
created_at
string<date-time>
account_id
string
client_onramp_reference
string
from
object
to
object
pricing
object