Address Verification

Verify ownership of a wallet address.

Webhook delivery. A verification that settles notifies every endpoint registered for the ADDRESS_VERIFICATION event family: ADDRESS_VERIFICATION_COMPLETED when the signature checks out, ADDRESS_VERIFICATION_FAILED otherwise. Delivery is at-least-once and retried — an endpoint that answers 5xx, or that cannot be reached at all, is retried with exponential backoff (1s, doubling to a 120s cap) for up to 12 attempts spanning roughly 10 minutes. Every attempt of one delivery repeats the same request_id, so a receiver may dedupe on it. An endpoint that answers 4xx is not retried: a definitive rejection cannot be changed by re-sending identical content. A delivery that exhausts the retry window is not redelivered later.

Request Wallet Verification

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

addressstring · min: 3Required

chainstring · min: 3Required

Body

emailstring · nullableOptionalDeprecated

Deprecated and ignored. Ospree does not send anything to this address. The verification link is returned in the response body, and delivering it to the wallet holder is the caller's responsibility. Any value supplied is discarded rather than stored.

Example: [e-mail]

Responses

200

A wallet-verification link was minted.

application/json

anyOptional

401

Unauthorized

application/json

422

Unprocessable Entity - Validation Error

application/json

500

Internal Server Error

application/json

post/api/v2/analytics/verification/chains/{chain}/addresses/{address}

POST /api/v2/analytics/verification/chains/{chain}/addresses/{address} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "status": "success",
  "data": {
    "link": "https://verify.ospree.io/acv/9f2c1d7e4b0a68350c4d1e2f3a4b5c6d"
  }
}