POST
https://api.stableyard.fi
/
sdk
/
v1
/
update-preferences
curl -X POST https://api.stableyard.fi/sdk/v1/update-preferences \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID:$STABLEYARD_APP_SECRET | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_abc123",
    "preferredSettlementChain": 8453,
    "preferredSettlementToken": "USDC"
  }'

{
  "success": true,
  "message": "Preferences updated successfully",
  "data": {
    "userId": "user_abc123",
    "preferredSettlementChain": 8453,
    "preferredSettlementToken": "USDC"
  },
  "requestId": "req_xyz789"
}
Configure where and how a Money Account receives payments. Set the preferred blockchain and token for settlements to optimize for speed, cost, or user preference.

​
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
​
preferredSettlementChain
integer
Preferred chain ID for receiving settlements (e.g., 8453 for Base, 137 for Polygon)
​
preferredSettlementToken
string
Preferred token for settlements (e.g., “USDC”, “USDT”)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
​
message
string
Status message
curl -X POST https://api.stableyard.fi/sdk/v1/update-preferences \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID:$STABLEYARD_APP_SECRET | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_abc123",
    "preferredSettlementChain": 8453,
    "preferredSettlementToken": "USDC"
  }'

{
  "success": true,
  "message": "Preferences updated successfully",
  "data": {
    "userId": "user_abc123",
    "preferredSettlementChain": 8453,
    "preferredSettlementToken": "USDC"
  },
  "requestId": "req_xyz789"
}

​
Supported Chains

ChainChain ID
Ethereum1
Base8453
Polygon137
Arbitrum42161
Optimism10
Optimizing for gas costs — Base (8453) and Polygon (137) typically have lower transaction fees, making them ideal default choices for frequent, smaller settlements.