​
Stableyard SDK API

The Stableyard SDK API provides programmatic access to Money Account infrastructure, enabling you to build payment flows, manage vaults, and process settlements. Base URL: https://api.stableyard.fi

​
API Categories

Account APIs

Create and manage Money Accounts

Vault APIs

Deploy vaults and query balances

Payment APIs

Create quotes and execute settlements

KYC APIs

Identity verification management

​
Authentication

All API requests require the x-sdk-key header: 
curl -X GET https://api.stableyard.fi/sdk/v1/get-user?userId=user_123 \
  -H "x-sdk-key: YOUR_API_KEY"
Get API AccessContact us for your API key:

​
Response Format

All responses follow a consistent structure: 
{
  "success": true,
  "data": { ... },
  "requestId": "uuid-request-id"
}
Error responses: 
{
  "success": false,
  "error": "Error message",
  "requestId": "uuid-request-id"
}

​
Endpoints Summary

​
Account Endpoints

EndpointMethodDescription
/sdk/v1/registerPOSTCreate new Money Account
/sdk/v1/get-userGETGet user by ID or username
/sdk/v1/get-user-byaddressGETGet user by wallet address
/sdk/v1/check-usernameGETCheck username availability
/sdk/v1/update-usernamePOSTUpdate user’s username
/sdk/v1/resolveGETResolve payment address

​
Vault Endpoints

EndpointMethodDescription
/sdk/v1/create-vaultPOSTDeploy Safe vault
/sdk/v1/deploy-role-modulePOSTDeploy role module
/sdk/v1/get-balancePOSTGet single chain balance
/sdk/v1/get-balancesGETGet all chain balances

​
Deposit Endpoints

EndpointMethodDescription
/sdk/v1/generatePOSTGenerate deposit address
/sdk/v1/verify-transferPOSTVerify transfer completion
/sdk/v1/get-deposit-addressPOSTGet deposit address with quote

​
Payment Endpoints

EndpointMethodDescription
/sdk/v1/quotePOSTCreate payment quote
/sdk/v1/settlePOSTExecute settlement
/sdk/v1/get-transactionsGETGet transaction history

​
KYC Endpoints

EndpointMethodDescription
/sdk/v1/is-kyc-doneGETCheck KYC status
/sdk/v1/update-kycPOSTUpdate KYC status
/sdk/v1/get-kyc-linkGETGet KYC verification link

​
Rate Limits

TierRequests/Minute
Standard60
Business300
EnterpriseCustom

​
Supported Chains

ChainChain IDStatus
Ethereum1Active
Base8453Active
Arbitrum42161Active
Polygon137Active
Optimism10Active

​
Quick Start

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.stableyard.fi';

// Create a user
const userRes = await fetch(`${BASE_URL}/sdk/v1/register`, {
  method: 'POST',
  headers: { 'x-sdk-key': API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    partnerId: 'your_partner_id',
    username: 'alice',
    addresses: ['0x...']
  })
});
const user = await userRes.json();

// Create vault
const vaultRes = await fetch(`${BASE_URL}/sdk/v1/create-vault`, {
  method: 'POST',
  headers: { 'x-sdk-key': API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ userId: user.data.userId })
});
const vault = await vaultRes.json();

// Create payment quote
const quoteRes = await fetch(`${BASE_URL}/sdk/v1/quote`, {
  method: 'POST',
  headers: { 'x-sdk-key': API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    userId: user.data.userId,
    partnerId: 'your_partner_id',
    amount: '100.00',
    destinationPaymentAddress: 'merchant@stableyard'
  })
});
const quote = await quoteRes.json();
Next: Learn about Authentication — API key management and security.