Skip to main content

Lookup & Inspect Address

Advanced address inspection and validation workflows for comprehensive account analysis.

Address Resolution & Validation​

Name Resolution​

Convert human-readable names to Bech32 addresses:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "https://api.provlabs.com/provenance/name/v1/resolve/pb:user.alice"

SPEC →

Bech32 Validation​

Parse address to bytes:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "https://api.provlabs.com/cosmos/auth/v1beta1/bech32/pb1YOURADDRESS..."

SPEC →

Encode bytes to address:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "https://api.provlabs.com/cosmos/auth/v1beta1/bech32/0123ABCDEF..."

SPEC →

Sanctions Check​

Verify address is not on sanctions list:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/sanction/v1beta1/check/pb1YOURADDRESS..."

SPEC →

Account Information​

Basic Account Info​

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/auth/v1beta1/account_info/pb1ADDRESS..."

SPEC →

Balance Information​

All balances:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/bank/v1beta1/balances/pb1ADDRESS..."

Spendable balances:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/bank/v1beta1/spendable_balances/pb1ADDRESS..."

Specific denom balance:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/bank/v1beta1/balances/pb1ADDRESS.../by_denom?denom=nhash"

Spendable for specific denom:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/bank/v1beta1/spendable_balances/pb1ADDRESS.../by_denom?denom=nhash"

SPEC →

Plus UI-Ready Data​

Address Metadata​

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_PLUS_BASE/v1/addresses/pb1ADDRESS.../metadata"

SPEC →

Balance Details​

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_PLUS_BASE/v1/addresses/pb1ADDRESS.../balance/details"

SPEC →

Quarantine Status​

Pending Transfers​

All pending transfers to address:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/quarantine/v1beta1/funds/pb1RECIPIENT..."

Pending transfers from specific sender:

Code snippet
curl -H "Authorization: Bearer $PROV_API_TOKEN" \
  "$PROV_REST_BASE/cosmos/quarantine/v1beta1/funds/pb1RECIPIENT.../pb1SENDER..."

SPEC →

Error Handling​

Invalid Address Format​

Error: invalid_argument - Invalid Bech32 address format

Fix: Ensure address includes correct network prefix (pb1 for mainnet, tp1 for testnet)

Account Not Found​

Error: not_found - Account not found

Fix: Verify address is correct and account has been initialized

Sanctions Check​

Response: Boolean indicating if address is sanctioned

Action: Block onboarding if true