Developer Docs

Appearance

Execute Buy EUR​

POST
/api/v4/otc/buy-eur/execute

Confirm a buy-EUR quote and begin the OTC flow. The response includes an orderId for polling and the Holyheld collection IBAN to which the OTC customer must send the quoted EUR amount.

Authorizations​

ApiKeyAuth
Type
API Key (header: X-Api-Key)

Request Body​

application/json
JSON
{
"quoteId": "79a89717-3690-4db0-b434-39e25df01d55",
"ibanId": "iban_01HXYZ123456",
"reference": "OTC buy 2024-04"
}

Responses​

OK

application/json
JSON
{
"status": "ok",
"payload": {
"orderId": "f0e2d8b3-1a4c-4f6e-9d5b-8c7f3e2a1b0d",
"quoteId": "79a89717-3690-4db0-b434-39e25df01d55",
"receiveAddress": "0x1234....2345",
"status": "CONFIRMED"
}
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

Code examples ​

bash
curl -X POST https://api.brrr.network/api/v4/otc/buy-eur/execute \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quoteId": "79a89717-3690-4db0-b434-39e25df01d55",
    "ibanId": "iban_01HXYZ123456",
    "reference": "OTC buy 2024-04"
  }'
javascript
const response = await fetch('https://api.brrr.network/api/v4/otc/buy-eur/execute', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.BRRR_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    quoteId: '79a89717-3690-4db0-b434-39e25df01d55',
    ibanId: 'iban_01HXYZ123456',
    reference: 'OTC buy 2024-04',
  }),
});

const order = await response.json();
console.log('Order:', order);
python
import os
import httpx

response = httpx.post(
    'https://api.brrr.network/api/v4/otc/buy-eur/execute',
    headers={
        'X-Api-Key': os.environ['BRRR_API_KEY'],
        'Content-Type': 'application/json',
    },
    json={
        'quoteId': '79a89717-3690-4db0-b434-39e25df01d55',
        'ibanId': 'iban_01HXYZ123456',
        'reference': 'OTC buy 2024-04',
    },
)
response.raise_for_status()
print('Order:', response.json())