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 register an Ethereum wallet address with ArcPass. If the address has never been seen before, a new wallet profile is created and the response returns 201 Created. If the address is already registered, the existing profile is returned with 200 OK. This endpoint is idempotent — calling it multiple times for the same address is safe.

​
Request

POST /wallets/register
​
walletAddress
string
required
The Ethereum address to register. Must be a checksummed or lowercase hex address matching the pattern ^0x[0-9a-fA-F]{40}$. Maximum length is 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
400walletAddress is missing or does not match the required hex pattern.
422Validation error — the request body contains unexpected fields or a malformed value.
curl --request POST \
  --url https://api.arcpass.io/wallets/register \
  --header "Content-Type: application/json" \
  --data '{"walletAddress": "0xAbC1234567890dEF1234567890aBcDeF12345678"}'

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