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 retrieve the full sponsorship history for a registered wallet address. Results are returned in pages using cursor-based pagination. Each page includes a cursor value you can pass to the next request to retrieve the following page.

​
Request

GET /wallets/:address/history
​
address
string
required
The Ethereum address whose history you want to retrieve. Must match ^0x[0-9a-fA-F]{40}$ and be at most 42 characters.
​
cursor
string
UUID of the last item from the previous page. Omit this parameter to start from the beginning of the history. Pass the cursor value returned in the previous response to fetch the next page.
​
limit
integer
default:"50"
Number of results to return per page. Accepts integers between 1 and 100 inclusive. Defaults to 50 if not provided.

​
Response

The response is a paginated object containing a list of sponsorship request records and a cursor for fetching the next page.
​
requests
array
required
Array of sponsorship request records for this wallet. Each record includes the following fields:
​
nextCursor
string
UUID cursor to pass as the cursor query parameter to fetch the next page of results. null if there are no more pages.
If the wallet address is not registered in ArcPass, this endpoint returns 404 Not Found. Register the wallet first using POST /wallets/register before querying its history.

​
Errors

StatusCause
400The :address path parameter does not match the required hex pattern.
404No wallet with this address is registered in ArcPass.
422The cursor is not a valid UUID, or limit is outside the 1–100 range.
curl --request GET \
  --url "https://api.arcpass.io/wallets/0xAbC1234567890dEF1234567890aBcDeF12345678/history?limit=10&cursor=3f2a1c8e-9b4d-4e7f-a1d2-0c6f8e3b5a9d"
200
{
  "requests": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "walletId": "3f2a1c8e-9b4d-4e7f-a1d2-0c6f8e3b5a9d",
      "status": "completed",
      "requestedAt": "2025-05-11T10:30:00.000Z",
      "approvedAt": "2025-05-11T10:30:08.000Z",
      "completedAt": "2025-05-11T10:30:22.000Z",
      "failedAt": null,
      "rejectedAt": null
    }
  ],
  "nextCursor": null
}