Connect a proven external wallet to an offer option
For options without a whitelisted-wallet requirement, submitting when a wallet is already connected updates the existing binding in place, keeping its id. Options with a whitelisted-wallet requirement accumulate wallets up to the requirement’s max_wallets and then reject with max_wallets_reached.
Authorizations
OAuth 2.0 authorization and token endpoints
Path Parameters
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.
The blockchain network the wallet belongs to.
ethereum_sepolia, base_sepolia, solana_devnet, ethereum_mainnet, base_mainnet, solana_mainnet "ethereum_sepolia"
The ID of the offer option to connect the wallet to.
The cryptographic signature of the challenge message.
"0xdeadbeef"
The external wallet address. For EVM chains, must be a valid Ethereum address (normalized to lowercase).
"0x742d35cc6634c0532925a3b844bc9e7595f0beb1"
Response
Successful response.
A user's proven external wallet connected to an offer option.
The connected external wallet address.
When the binding was created.
"2025-01-01T00:00:00.000000Z"
Unique identifier for the object.
"05edea81-98a7-4582-aa7c-040d57cb1858"
The ID of the offer option.
"05edea81-98a7-4582-aa7c-040d57cb1858"
The protocol the binding is scoped to. An EVM address binds once per option regardless of which EVM chain proved ownership.
ethereum, solana