Skip to main content
POST
Connect a proven external wallet to an offer option

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization and token endpoints

Path Parameters

offer_id
string
required

The ID of the offer

Body

Offer option address params

Connects a proven external wallet to an offer option. Requires a previously generated, unconsumed wallet-ownership challenge for the same wallet and chain. The signature is verified and the single-use challenge consumed during ownership verification, before the bind. A rejected bind does not roll back the consume, so the user re-signs to retry.

chain
enum<string>
required

The blockchain network the wallet belongs to.

Available options:
ethereum_sepolia,
base_sepolia,
solana_devnet,
ethereum_mainnet,
base_mainnet,
solana_mainnet
Example:

"ethereum_sepolia"

offer_option_id
string
required

The ID of the offer option to connect the wallet to.

signature
string
required

The cryptographic signature of the challenge message.

Example:

"0xdeadbeef"

wallet_address
string
required

The external wallet address. For EVM chains, must be a valid Ethereum address (normalized to lowercase).

Example:

"0x742d35cc6634c0532925a3b844bc9e7595f0beb1"

Response

Successful response.

A user's proven external wallet connected to an offer option.

address
string
required

The connected external wallet address.

created_at
string<date-time>
required

When the binding was created.

Example:

"2025-01-01T00:00:00.000000Z"

id
string
required

Unique identifier for the object.

Example:

"05edea81-98a7-4582-aa7c-040d57cb1858"

offer_option_id
string
required

The ID of the offer option.

Example:

"05edea81-98a7-4582-aa7c-040d57cb1858"

protocol
enum<string>
required

The protocol the binding is scoped to. An EVM address binds once per option regardless of which EVM chain proved ownership.

Available options:
ethereum,
solana