Get Wallet Status

Retrieve linking status, tier limits, and accepted chains for a specific wallet.

GET /v1/wallets/{address}

cURL

curl --request GET \
  --url https://api.havn.finance/v1/wallets/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
  --header 'Authorization: Bearer havn_live_abc123def456'

200 - Success

{
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "tier": "High",
  "lifetimeVolumeUsd": 4250.75,
  "remainingLimit": 1500.00,
  "isActive": true
}

Authorization

Authorization · string · required

Bearer token. Format: Bearer <token>

Path Parameters

address · string · required

The public address of the Web3 wallet.

Response

address · string

The queried wallet address.

tier · string

The assigned Havn Ecosystem Tier based on historical funding volume. Values: Standard, High, Max

lifetimeVolumeUsd · number

The total USD value this wallet has successfully converted into virtual cards.

remainingLimit · number

The remaining funding limit (in USD) for the current 24-hour window, based on the wallet’s tier.

isActive · boolean

Whether the wallet is currently eligible to provision new cards.

cURL

curl --request GET \
  --url https://api.havn.finance/v1/wallets/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
  --header 'Authorization: Bearer havn_live_abc123def456'

200 - Success

{
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "tier": "High",
  "lifetimeVolumeUsd": 4250.75,
  "remainingLimit": 1500.00,
  "isActive": true
}