Create Wallet Address

Generate a new deposit address

Supported addresstype values:

usdc
usdt
btc
sol
eth

curl -X POST "https://api.yara.cash/api/v1/wallet?reference=<reference>&addresstype=<type>" \
  -H "Content-Type: application/json" \
  -H "x-yara-api-key: <secret-key>" \
  -d '{
    "reference": "reference-1",
    "addresstype": "ETH"
    }'

Response

{
    "data": {
        "address": "0x6880965551E505005915b7cA4c43dB09F4bB000330",
        "addressType": "ETH",
        "createdAt": "2025-11-02T16:43:16.334189+01:00",
        "id": "745fe7e1-8ea3-4363-8808-740c6befece5",
        "reference": "reference-1",
        "updatedAt": "2025-11-02T16:43:16.334189+01:00"
    },
    "message": "success"
}

Get Wallet Address

Returns a wallet address by reference.

GET /api/v1/wallet?reference=<reference>

curl -X GET "https://api.yara.cash/api/v1/wallet?reference=<reference>" \
  -H "x-yara-api-key: <secret-key>" \
  -H "Content-Type: application/json"

Response

{
    "data": {
        "pagination": {
            "limit": <limit>,
            "page": <page>,
            "total": <total>
        },
        "payouts": [
            {
                "id": <id>,
                "accountId": <accountId>,
                "type": <type>,
                "status": <status>,
                "amount": <amount>,
                "currency": <currency>,
                "counterpartyName": <counterpartyName>,
                "createdAt": <createdAt>,
                "payoutIntentId": <payoutIntentId>,
                "payoutType": <payoutType>,
                "exchangeRate": <exchangeRate>,
                "fees": <fees>,
                "fiatAmount": <fiatAmount>,
                "fiatCurrency": <fiatCurrency>
            }
        ]
    },
    "message": "success"
}