GET /wallets/:address — Look Up a Wallet

Use this endpoint to fetch the current profile for a registered wallet address. You can call it to check whether a wallet is known to ArcPass, how many sponsorship requests it has submitted, and whether it has been blocked.

Request

GET /wallets/:address

string

required

The Ethereum address to look up. Must match ^0x[0-9a-fA-F]{40}$ and be at most 42 characters.

Response

string

required

UUID uniquely identifying this wallet record.

string

required

The registered Ethereum address, normalized to lowercase.

string

required

ISO 8601 timestamp of when this wallet was first registered with ArcPass.

string

required

ISO 8601 timestamp of the most recent interaction with this wallet.

integer

required

Total number of sponsorship requests ever submitted for this wallet.

boolean

required

Whether this wallet has been flagged and blocked from receiving sponsorships.

Errors

Status	Cause
`400`	The `:address` path parameter does not match the required hex pattern.
`404`	No wallet with this address is registered in ArcPass.

curl --request GET \
  --url https://api.arcpass.io/wallets/0xAbC1234567890dEF1234567890aBcDeF12345678

200

{
  "id": "3f2a1c8e-9b4d-4e7f-a1d2-0c6f8e3b5a9d",
  "walletAddress": "0xabc1234567890def1234567890abcdef12345678",
  "firstSeenAt": "2025-05-10T08:00:00.000Z",
  "lastSeenAt": "2025-05-11T10:22:00.000Z",
  "sponsorshipCount": 1,
  "isBlocked": false
}

Overview

Wallets

Sponsorship

System

GET /wallets/:address — Look Up a Wallet

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors