Start authentication

POSThttps://api.agg.market/auth/start

Initiates an auth flow. Required fields depend on the provider:

google — send redirectUrl, returns a redirect (OAuth URL)
twitter — send redirectUrl, returns a redirect (OAuth URL)
email — send email and optionally redirectUrl, returns a magic_link
siwe — no fields, returns a nonce
siws — no fields, returns a nonce

When bot protection is active, wallet/email auth may return challenge_required. Render a Cloudflare Turnstile widget using the returned siteKey and resubmit with the resulting turnstileToken.

Loading code example

Loading code example

Authorizations

appIdstringheaderrequired

API key passed in the header.

Body

redirectUrlstring<uri>

emailstring<email>

Length: <= 254

turnstileTokenstring

earlyAccessCodestring

Response

application/json

200

type"redirect" | "magic_link" | "nonce" | "challenge_required"required

Allowed values: "redirect" | "magic_link" | "nonce" | "challenge_required"

urlstring

successtrue

Allowed values: true

noncestring

statementstring

siteKeystring