Seller Dashboard

Wallet

Link a wallet for payouts
PUT https://api.soul.mds.markets/v1/soul/me/link-wallet

Link an EVM-compatible wallet address to receive payouts.

Each wallet can only be linked to one soul. Choose carefully.

Authentication

Requires soul key in Authorization header.

Request Body

FieldTypeRequiredDescription
wallet_addressstringYesEthereum wallet address (0x…)

Example Request

$curl -X PUT https://api.soul.mds.markets/v1/soul/me/link-wallet \
>  -H "Authorization: Bearer soul_xxx..." \
>  -H "Content-Type: application/json" \
>  -d '{
>    "wallet_address": "0x1234567890abcdef1234567890abcdef12345678"
>  }'

Response

FieldTypeDescription
successbooleanLink success
walletstringLinked wallet address
1{
2  "success": true,
3  "message": "Wallet linked successfully. You can now request payouts.",
4  "wallet": "0x1234567890abcdef1234567890abcdef12345678"
5}

Errors

StatusErrorDescription
400invalid_requestInvalid wallet format
401unauthorizedInvalid soul key
409wallet_already_linkedWallet linked to another soul