Builder ServiceAPI ReferenceHTTP APIAuth
Auth: Verify Revoke
Verify revoke and delete the delegate wallet record.
Alpha Version
The Ostium Builder Service is in Alpha. API endpoints, specifications, and builder URLs may change without notice. Use with caution in production environments.
POST /v1/auth/verify-revoke
Verifies delegation removal and USDC allowance revocation, then deletes the delegate wallet record.
Headers
| Header | Required | Description |
|---|---|---|
X-Trader-Address | Yes | Trader wallet address. |
Content-Type | Yes | application/json or text/plain (JSON string). |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Message returned by /v1/auth/revoke. |
signature | string | Yes | Signature for the message. |
Response Body
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Yes | Whether the action succeeded. |
smartAccountAddress | string | Yes | Smart account address. |
delegatedTo | string | Yes | Current delegate address. |
allowance | string | Yes | USDC allowance in base units. |
Example
curl -X POST https://builder.ostiscan.xyz/v1/auth/verify-revoke \
-H "Content-Type: application/json" \
-H "X-Trader-Address: 0xYourWallet" \
-d '{"message":"<message>","signature":"0x..."}'Example Response
{
"success": true,
"smartAccountAddress": "0x...",
"delegatedTo": "0x0000000000000000000000000000000000000000",
"allowance": "0"
}Notes
- This endpoint requires delegation to be removed and allowance to be revoked on-chain.
Errors
See /docs/errors.