​
Developer Layer

Stableyard provides comprehensive tools for wallets, apps, SaaS platforms, fintechs, and games to integrate stablecoin payments.

​
API Categories

Money Account API

Create and manage accounts for your users. No chain management required.

Payouts API

Send payments to any user or handle programmatically.

Deposits API

Generate deposit addresses and detect incoming transfers.

Webhooks

Real-time notifications for payment status changes.

​
Quick Start

​
1. Get Credentials

Contact us for API access:

​
2. Register a User

curl -X POST https://api.stableyard.fi/sdk/v1/register \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID:$STABLEYARD_APP_SECRET | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice",
    "addresses": ["0x..."]
  }'

​
3. Create Vault

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

​
4. Accept Payment

curl -X POST https://api.stableyard.fi/sdk/v1/quote \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "payer_user_id",
    "amount": "100.00",
    "destinationPaymentAddress": "merchant@stableyard"
  }'

​
Integration Flow

​
API Reference

​
Account Endpoints

EndpointMethodDescription
/sdk/v1/registerPOSTCreate Money Account
/sdk/v1/get-userGETGet user by ID or username
/sdk/v1/check-usernameGETCheck username availability
/sdk/v1/resolveGETResolve payment address

​
Vault Endpoints

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

​
Payment Endpoints

EndpointMethodDescription
/sdk/v1/quotePOSTCreate payment quote
/sdk/v1/settlePOSTExecute settlement
/sdk/v1/get-deposit-addressPOSTGet deposit address

​
KYC Endpoints

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

​
Universal Deposit Addresses

Generate chain-specific deposit addresses that route to user’s Money Account: 
curl -X POST https://api.stableyard.fi/sdk/v1/generate \
  -H "Authorization: Basic $(echo -n $STABLEYARD_APP_ID | base64)" \
  -d '{
    "userId": "user_abc123",
    "chainId": 8453
  }'
Deposits are automatically:
  • Detected by watchers
  • Swapped if needed
  • Credited to user balance

​
Webhook Events

EventDescription
payment.createdPayment order created
payment.pendingAwaiting confirmation
payment.completedPayment settled
payment.failedPayment failed
account.createdMoney Account registered
vault.createdVault deployed
kyc.completedKYC verified

​
SDKs

LanguageStatus
TypeScript/JavaScriptAvailable
PythonComing Soon
GoComing Soon

​
Security

  • All API calls require Authorization header with Basic auth (STABLEYARD_APP_ID:STABLEYARD_APP_SECRET for Account/Vault APIs, STABLEYARD_APP_ID only for others)
  • Webhook signatures should be verified
  • Vaults are non-custodial
  • Policy engine enforces transaction rules
Full API documentation: See SDK & API Reference