Auth: Verify

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-auth

Verifies on-chain delegation and USDC allowance for the delegate wallet. Requires X-API-Key.

Headers

Header	Required	Description
`X-Trader-Address`	Yes	Trader wallet address.
`X-API-Key`	Yes	API key created via `/v1/auth/create`.
`Content-Type`	No	`application/json` or `text/plain` (JSON string).

Request Body

An empty JSON object is acceptable.

Response Body

Field	Type	Required	Description
`verified`	`boolean`	Yes	Whether delegation is verified on-chain.
`smartAccountAddress`	`string`	Yes	Smart account address.
`allowance`	`string`	Yes	USDC allowance in base units.

Example

curl -X POST https://builder.ostiscan.xyz/v1/auth/verify-auth \
  -H "Content-Type: application/json" \
  -H "X-Trader-Address: 0xYourWallet" \
  -H "X-API-Key: <apiKey>" \
  -d '{}'

Example Response

{
  "verified": true,
  "smartAccountAddress": "0x...",
  "allowance": "1000000"
}

Errors

See /docs/errors.