Skip to main content
This guide covers the cash-out flow: your user deposits crypto (USDC on Polygon), it’s converted to EUR, and the balance is available on their Bringin debit card to spend anywhere or withdraw to their bank.

​
1. Get User ID

This API returns the userId, which you’ll need for some admin operations. 
GET /api/v0/user/user-id
Response
{
  "userId": "34c3b5a7-ae2d-4390-9f46-2c4e246149cf"
}

​
2. Get Rates

Returns the latest market rate. When creating an order, use the latest rate. We account for minor slippage and slight delays. The rate includes the fee from Bringin plus any additional markup you wish to add. 
POST /api/v0/offramp/rates
Request
{
  "ticker": "USDCEUR"
}
Response
{
  "ticker": "USDCEUR",
  "price": "0.91",
  "bringinPrice": "0.9018",
  "currency": "EUR",
  "timestamp": 1742911487157
}
FieldDescription
priceMarket rate
bringinPriceThe price at which the swap happens (after fees)
We currently support USDCEUR and BTCEUR. More pairs coming soon.

​
3. Get Deposit Address

Creates an offramp order and returns a USDC deposit address. 
POST /api/v0/offramp/address
Request
{
  "ipAddress": "212.30.36.15",
  "sourceCurrency": "USDC",
  "sourceBlockchain": "POLYGON"
}
Response
{
  "maximumDepositAmount": "1666667",
  "minimumDepositAmount": "15",
  "address": "0x7D162a2B5e88277F8b51D8548B2BC1a2E89558E7"
}
The user sends USDC to this address. Once confirmed on-chain, we swap USDC to EUR at market rate. The EUR balance is then available on their Bringin debit card.
Amounts are in USDC cents (6 decimals). 15 = 0.000015 USDC minimum, 1666667 = 1,666.667 USDC maximum.

​
4. Check Balance

POST /api/v0/account/get-balance
Request
{
  "currency": "EUR"
}
Response
{
  "balance": "12992"
}
Balance is in EUR cents. 12992 = €129.92

​
5. List Transactions

POST /api/v0/account/transactions/
Request
{
  "startDate": 1705587099046,
  "endDate": 1704047400000,
  "limit": "100",
  "offset": "0"
}
All fields are optional. Dates are Unix timestamps in milliseconds.
Response
{
  "transactions": [
    {
      "orderId": "3521154c-30b4-480c-834d-38f80d507963",
      "type": "OFFRAMP_WITHOUT_FIAT_WITHDRAWAL",
      "subType": "ONCHAIN",
      "sourceAmount": "100000",
      "sourceCurrency": "USDC",
      "destinationAmount": "3816",
      "destinationCurrency": "EUR",
      "status": "SUCCESSFUL",
      "createdAt": "2024-01-18T14:02:59.709Z"
    }
  ],
  "number": 1,
  "totalCount": 4
}