Skip to main content

​
Introduction

The Sardis API enables AI agents to make secure, policy-controlled financial transactions using non-custodial MPC wallets and stablecoins.

​
Base URL

https://api.sardis.sh/api/v2
For development and testing: 
https://api-staging.sardis.sh/api/v2

​
API Versioning

The Sardis API uses URL-based versioning. The current version is v2.
  • Current Version: /api/v2
  • Version Format: Semantic versioning for breaking changes
  • Deprecation: 90-day notice for deprecated endpoints

​
Common Patterns

​
Request Format

All POST/PUT/PATCH requests accept JSON bodies: 
{
  "name": "shopping-agent",
  "description": "Agent for e-commerce purchases"
}

​
Response Format

All successful responses return JSON: 
{
  "agent_id": "agent_abc123",
  "name": "shopping-agent",
  "created_at": "2025-03-03T10:00:00Z"
}

​
Pagination

List endpoints support pagination via query parameters:
  • limit: Number of items to return (default: 50, max: 100)
  • offset: Number of items to skip (default: 0)
GET /api/v2/agents?limit=20&offset=40

​
Idempotency

POST endpoints support idempotency keys to prevent duplicate operations: 
POST /api/v2/wallets/{wallet_id}/transfer
Idempotency-Key: unique-key-123
If you retry a request with the same key within 24 hours, you’ll receive the original response.

​
Filtering

Many list endpoints support filtering: 
GET /api/v2/agents?is_active=true
GET /api/v2/wallets?agent_id=agent_123

​
Error Handling

All errors return a consistent format (see Errors).

​
Resource Hierarchy

Organization
  └─ Agents
      ├─ Wallets
      │   ├─ Transfers
      │   └─ Balances
      ├─ Policies
      └─ Cards (Virtual)
  └─ Groups
      └─ Shared Budgets
  └─ Ledger Entries

​
Supported Chains

ChainNetworkToken Support
BaseMainnetUSDC, EURC
Base SepoliaTestnetUSDC
EthereumMainnetUSDC, USDT, PYUSD, EURC
PolygonMainnetUSDC, USDT, EURC
ArbitrumMainnetUSDC, USDT
OptimismMainnetUSDC, USDT
ArcCircle L1USDC, EURC

​
Supported Tokens

  • USDC - USD Coin (primary)
  • USDT - Tether USD
  • EURC - Euro Coin
  • PYUSD - PayPal USD (Ethereum only)

​
SDK Availability

  • Python SDK: pip install sardis-sdk
  • TypeScript SDK: npm install @sardis/sdk
  • MCP Server: npx @sardis/mcp-server

​
Quick Start

  1. Authenticate with your API key
  2. Create an agent
  3. Create a wallet
  4. Transfer funds
  5. Check ledger

​
Rate Limits

See Rate Limits for detailed information.

​
Need Help?

Build docs developers (and LLMs) love

Get started for freeTalk to us