POST
https://api.stableyard.fi
/
sdk
/
v1
/
add-address
curl -X POST https://api.stableyard.fi/sdk/v1/add-address \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID:$STABLEYARD_APP_SECRET | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_abc123",
    "address": "0x9876543210fedcba9876543210fedcba98765432",
    "chainType": "evm",
    "signature": "0x...",
    "message": "Link this wallet to my Stableyard account: user_abc123"
  }'

{
  "success": true,
  "message": "Address linked successfully",
  "data": {
    "userId": "user_abc123",
    "addresses": [
      { "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...", "chainType": "evm" },
      { "address": "0x9876543210fedcba9876543210fedcba98765432", "chainType": "evm" }
    ]
  },
  "requestId": "req_xyz789"
}
Connect an additional wallet to an existing Money Account. Users can link multiple wallets across different chains (EVM, Solana, Aptos) to their single Money Account identity.

​
Authentication

​
Authorization
string
required
Basic authentication. Value: Basic base64(STABLEYARD_APP_ID:STABLEYARD_APP_SECRET). Obtain your credentials from the Stableyard SDK.

​
Body Parameters

​
userId
string
required
Money Account’s unique identifier
​
address
string
required
The wallet address to link
​
chainType
string
required
Chain type: evm, solana, or aptos
​
signature
string
required
Signature proving ownership of the address. The user must sign a message with the wallet being added.
​
message
string
required
The message that was signed (for verification)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
​
message
string
Status message
curl -X POST https://api.stableyard.fi/sdk/v1/add-address \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID:$STABLEYARD_APP_SECRET | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_abc123",
    "address": "0x9876543210fedcba9876543210fedcba98765432",
    "chainType": "evm",
    "signature": "0x...",
    "message": "Link this wallet to my Stableyard account: user_abc123"
  }'

{
  "success": true,
  "message": "Address linked successfully",
  "data": {
    "userId": "user_abc123",
    "addresses": [
      { "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...", "chainType": "evm" },
      { "address": "0x9876543210fedcba9876543210fedcba98765432", "chainType": "evm" }
    ]
  },
  "requestId": "req_xyz789"
}

​
Use Cases

  • Hardware wallet — User wants to add a more secure signing wallet
  • Multi-chain — User initially registered with EVM, now wants to add Solana
  • New device — User got a new phone with a new wallet app
Signature required — To prevent unauthorized linking, users must sign a message proving they own the wallet being added. This protects against account takeover attacks.