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