Skip to main content
Use this endpoint to submit an Ethereum wallet address for gas sponsorship on Arc Network. ArcPass validates eligibility, applies rate limiting, and creates a sponsorship request that moves through the approval and relay pipeline asynchronously. The request captures the submitting IP address and user-agent automatically from the incoming HTTP request. You do not need to include them in the body.

​
Request

POST /sponsorship/request
​
string
required
The Ethereum address to sponsor. Must match ^0x[0-9a-fA-F]{40}$ and be at most 42 characters. The address is normalized to lowercase before processing.

​
Response

​
string
required
UUID of the newly created sponsorship request. Use this to poll status with GET /sponsorship/:id.
​
string
required
UUID of the wallet record associated with this sponsorship request.
​
string
required
The Ethereum address submitted for sponsorship, normalized to lowercase.
​
string
required
Initial status of the sponsorship request. Always "pending" on creation.
​
string
required
ISO 8601 timestamp of when the sponsorship request was created.
​
string
required
IP address of the client that submitted the request, captured from X-Forwarded-For or the raw socket address.
​
string
required
User-Agent header value from the request, or null if not present.

​
Errors

Replay protection: If the same walletAddress and IP address submit an identical request within 5 seconds, ArcPass returns the existing request rather than creating a duplicate.
201