Builder ServiceAPI ReferenceHTTP APIAuth
Auth: Revoke
Get revoke transaction and message.
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/revoke
Returns a remove-delegate transaction and a message to sign for revoke verification.
Headers
| Header | Required | Description |
|---|---|---|
X-Trader-Address | Yes | Trader wallet address. |
Response Body
| Field | Type | Required | Description |
|---|---|---|---|
removeDelegateTx | UnsignedTransaction | Yes | Transaction to remove delegation. |
smartAccountAddress | string | Yes | Smart account address. |
message | string | Yes | Message to sign for /v1/auth/verify-revoke. |
nonce | string | Yes | Nonce embedded in the message. |
expiresAt | string | Yes | ISO expiry time. |
UnsignedTransaction
| Field | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Contract address. |
data | string | Yes | ABI-encoded calldata. |
value | string | Yes | ETH value (usually "0"). |
from | string | No | Trader address. |
Example
curl -X POST https://builder.ostiscan.xyz/v1/auth/revoke \
-H "X-Trader-Address: 0xYourWallet"Example Response
{
"removeDelegateTx": { "to": "0x...", "data": "0x...", "value": "0", "from": "0x..." },
"smartAccountAddress": "0x...",
"message": "<signable message returned by server>",
"nonce": "0x...",
"expiresAt": "2026-02-05T12:34:56.789Z"
}Notes
- Revoke delegation and USDC allowance on-chain before calling
/v1/auth/verify-revoke.
Errors
See /docs/errors.