Stable Coin APIs Reference
Get Wallet Addresses
Purpose: Fetch on-chain wallet addresses associated with business/client
Endpoint:
GET /addresses
{
"clientId":null,
"businessId":"2344"
}
Response Sample:
{
"addresses": [
{
"id": "10000000020521",
"name": "Custodial",
"type": "internal",
"status": "active",
"address": "0xB2952EDba91FeAeaDBeCC4030203367A5B9b4701",
"created": "2023-03-07T17:31:37.997502Z",
"blockchains": [
"avalanche",
"ethereum",
"base",
]
}
]
}
Link External Wallet Address
Purpose: Link an external wallet address to a business
Endpoint:
POST /addresses/external
{
"businessId": 2323,
"name": "User Ethereum Wallet",
"blockchains": ["Ethereum", "Avalanche", "Polygon"],
"address": "0xD4Bc64E31c8F216B07F0156B76FC06Da94b73d26"
}
REsponse
{
"id": "10000000020521",
"name": "User Ethereum Wallet",
"status": "active",
"type": "external",
"address": "0xD4Bc64E31c8F216B07F0156B76FC06Da94b73d26",
"created": "2025-05-20T20:54:11.063281Z",
"blockchains": [
"Ethereum",
"Avalanche",
"Polygon"
]
}
Purpose: Fetching an Internal Balance
Endpoint:
POST /addresses/balance
{
"businessId": 2323,
"addressId": "2MhCCIHulVdXrHiEuQDJvnKbSkl"
}
Account to Stablecoin
Purpose: Convert fiat currency to stablecoin
Endpoint:
POST /accounts/transfers
{
"businessId": 2323,
"amount": {
"value": "10",
"currency": "USD"
},
"source": {
"accountId": "10000000019435"
},
"destination": {
"address_id": "10000000020521",
"currency": "sbc",
"blockchains": "base"
}
}
Stablecoin to Account
Purpose: Convert stablecoin to fiat currency
Endpoint:
POST /accounts/transfers
{
"businessId": 2323,
"amount": {
"value": "1",
"currency": "USD"
},
"source": {
"address_id": "10000000020521",
"currency": "SBC",
"blockchains": "Polygon"
},
"destination": {
"accountId": "10000000019435",
"externalAccountId":"10000000019435"
}
}
Stablecoin Swaps
Purpose: Exchange one stablecoin for another
Endpoint:
POST /accounts/transfers
{
"businessId": 2323,
"amount": {
"value": "100",
"currency": "USD"
},
"source": {
"address_id": "10000000020521",
"currency": "USDC",
"blockchains": "Solana"
},
"destination": {
"address_id": "10000000020566",
"currency": "YSBC",
"blockchains": "Solana"
}
}
Creating an Account
Purpose: Create a new business account with complete business and financial information
Endpoint:
POST /admin/business/accounts
{
"personalInfo": {
"firstName": "Chirag",
"lastName": "Bhimani",
"email": "[email protected]",
"phone": "8888846372",
"phoneCountryCode": "+2"
},
"address": {
"addressLine1": "3 Campbell Avenue",
"addressLine2": "string",
"zipCode": "95051",
"city": "Santa Clara",
"state": "CA",
"countryCode": "US"
},
"businessInfo": {
"company": "Suvicash",
"businessEin": "12-3456789",
"phoneNumber": "4081223333",
"businessIdentificationType": "Tax ID",
"stateOfIncorporation": "California",
"primaryIndustry": "Information Technology",
"subIndustry": "IT",
"companyType": "Private",
"companyWebsite": "https://suvicash.com",
"socialMedia": "ssdfdfsdfsfsf",
"companyMission": "To provide innovative tech solutions to improve business efficiency.",
"sourceOfFunds": "Business Revenues",
"customerSupplierBased": "Both",
"dateEstablished": "2015-06-15",
"no25PercentOwnership": true,
"agreeToTermsAndConditions": true
},
"financialInfo": {
"annualRevenue": "$5-$10 Million",
"approximateMonthlyTransaction": "5-15",
"approximateDepositFistMonth": "$5-$20M"
},
"keyPerson": {
"firstName": "Jak",
"phoneNumber": "9393939393",
"email": "[email protected]",
"lastName": "Smith",
"citizenship": "Doe",
"jobTitle": "CEO",
"identificationType": "SSN",
"identificationNumber": "129382738273",
"dateOfBirth": "2024-03-23",
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "Suite 22",
"zipCode": "31813-0977",
"city": "Springfield",
"state": "IL",
"countryCode": "US"
}
},
"owners": [
{
"firstName": "John",
"phoneNumber": "9393939393",
"email": "[email protected]",
"lastName": "string",
"citizenship": "Doe",
"jobTitle": "CEO",
"identificationType": "SSN",
"identificationNumber": "127382738273",
"dateOfBirth": "2024-03-23",
"ownershipPercentage": 30,
"no25PercentOwnership": true,
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "Suite 22",
"zipCode": "31813-0977",
"city": "Springfield",
"state": "IL",
"countryCode": "US"
}
}
],
"accountName": "Spending",
"correlationId": "gmswFC4mnCytXKchsxsmN1",
"clientIpAddress": "127.11.23.11"
}
Response Sample:
{
"referenceId": "78be6e24-8cee-47e0-9f22-b4fc3f582f80",
"accountNumber": "10000000020521",
"businessId": 1951,
"status": "REQUESTED",
"correlationId": "gmswFC4mnCytXKchsxsmN1e"
}
