POST
Link a venue account

Authorizations

Authorization
string
header
required

Master session from POST /v1/auth/verify. Revocable; expires after seven days by default. Required for financial operations.

Body

application/json
venue
string
required

A venue id from GET /v1/venues.

address
string
required

Responses are lowercase.

Pattern: ^0x[0-9a-fA-F]{40}$
nonce
string

From the link challenge; omitted for the master address.

signature
string

The link message signed by address; omitted for the master address.

Pattern: ^0x[0-9a-fA-F]{130}$

Response

The linked account.

venue
string
required

A venue id from GET /v1/venues.

address
string
required

Owner of the venue account; signs its transfers.

Pattern: ^0x[0-9a-fA-F]{40}$
venue_wallet
string | null
required

The venue's wallet next to the signer; null on venues without one.

Pattern: ^0x[0-9a-fA-F]{40}$
expires_at
string<date-time> | null
required

When the venue's authorization behind the link lapses and the account must link again: Aster's agent approval; null elsewhere.

linked_at
string<date-time>
required

RFC 3339 UTC; snapshots and history may keep fractional seconds.