​

Smart Account API

The Squads API enables you to create and manage smart accounts—fully onchain programmable wallets with industry-leading security features on the Solana blockchain. We handle all the blockchain complexity, so you can focus on building your application.

​

Built for Developers

• Zero Blockchain Expertise Required - No need to understand Solana’s technical details
• Infrastructure Management - We handle RPC nodes, indexing, and infrastructure scaling
• Gas Abstraction - Pay fees in any asset and even sponsor them for your users
• Enterprise Ready - Built-in reliability with automatic retries and confirmation tracking

​

Core Features

​

Flexible Custody Models

Choose the custody model that fits your needs:

• Self-custodial - Users maintain complete control
• Semi-custodial - Shared control between users and your application
• Multi-signature - Multiple keys for enhanced security or social recovery
• Bring Your Own Keys - Integrate with your existing key management infrastructure

​

Advanced Security Controls

• Spending Limits - Set daily, weekly, or custom transfer limits
• Timelocks - Delay certain operations based on configurable conditions
• Flexible Signing - Multiple types of signers for different security needs

​

Enterprise-Grade Security

• Multiple security audits and formal verification
• Secured by Solana’s decentralized network of 1000+ validators
• Battle-tested in production environments

​

API Access

​

Base URL

https://developer-api.squads.so

​

Required Headers

Authorization: Bearer YOUR_API_KEY
x-squad-network: devnet // or 'mainnet' for production

​

Fee Configuration

All transactions require a fee configuration that specifies how transaction fees will be paid. You can pay fees in either SOL or USDC - for full details on fee calculation, supported currencies, and response formats, see our supported fee currencies documentation.

Example fee configuration:

{
  "fee_config": {
    "currency": "usdc",
    "payer_address": "BmB8q3Q5N1CruWDjsnYXNnXhfL4bgQovEMYhzVLar1uR"
  }
}

​

Response Format

API responses vary by endpoint type but always follow these principles:

• All responses are returned in JSON format
• Error responses follow a consistent format
• Successful responses vary based on the endpoint type

​

Success Response Types

1. Transaction Endpoints Most endpoints return a prepared transaction and fee information:

{
  "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDpXW3HkEQR9QEa5C8/Qk4nJcaYkdlhqmxV4k",
  "fee": {
    "amount": "1000000",
    "amount_decimal": "1.0",
    "currency": "usdc",
    "sol_equivalent": {
      "amount": "5000",
      "amount_decimal": "0.000005"
    }
  }
}

2. Smart Account Creation The create smart account endpoint returns just the address:

{
  "smart_account_address": "AbCd...XyZ"  // Ready to use immediately
}

3. Query Endpoints Query endpoints return specific data structures relevant to their function. For example, getting spending limit details:

{
  "smart_account_address": "AbCd...XyZ",
  "spending_limit": {
    // Spending limit specific details
  }
}

​

Error Response

All endpoints use a consistent error format:

{
  "error": "Invalid request parameters"
}

​

Response Fields

Common fields you might encounter:

• transaction: Base64 encoded Solana transaction (when applicable)
• smart_account_address: The wallet address of a smart account
• fee: Fee information when a transaction is involved
  • amount: Raw amount in base units (e.g., USDC with 6 decimals)
  • amount_decimal: Human-readable amount
  • currency: The currency for the fee (e.g., “usdc”)
  • sol_equivalent: The equivalent SOL fee
    • amount: Raw amount in lamports
    • amount_decimal: Human-readable SOL amount

For endpoint-specific response details, refer to the individual endpoint documentation.