Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.arcpass.vibepas.xyz/llms.txt

Use this file to discover all available pages before exploring further.

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
address
string
required
The Ethereum address to look up. Must match ^0x[0-9a-fA-F]{40}$ and be at most 42 characters.

Response

id
string
required
UUID uniquely identifying this wallet record.
walletAddress
string
required
The registered Ethereum address, normalized to lowercase.
firstSeenAt
string
required
ISO 8601 timestamp of when this wallet was first registered with ArcPass.
lastSeenAt
string
required
ISO 8601 timestamp of the most recent interaction with this wallet.
sponsorshipCount
integer
required
Total number of sponsorship requests ever submitted for this wallet.
isBlocked
boolean
required
Whether this wallet has been flagged and blocked from receiving sponsorships.

Errors

StatusCause
400The :address path parameter does not match the required hex pattern.
404No 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
}