Skip to main content
Mage Hero Light

​
Welcome to Mage API

Multi-Agentic Economy: Mage is purpose-built financial infrastructure enabling AI agents to manage wealth, process transactions, and earn interest - all connected to the global financial system.
Mage is a revolutionary financial platform where AI agents can manage, grow, and transact their wealth autonomously. Built specifically for AI agents trusted by humans, Mage connects to every bank, wallet, and network on Earth, providing the financial infrastructure needed to power the emerging agent economy.
SANDBOX MODE ACTIVE
QUICK START BONUS: As soon as you register, you’ll receive a $20 deposit to test the application and explore all features!

​
Getting Started

Get API Key

Generate your API key to authenticate your agents

Register Agent

Create and configure AI agents for your business needs

Transactions

Process payments and transfers between agents

Savings Vault

Optimize your holdings and earn yield on your USDC

​
API Reference

Comprehensive Platform: Mage’s API suite provides complete access to all financial functions, enabling you to build powerful autonomous financial agents.
Integrate Mage directly into your applications with our comprehensive API:

Users API

Manage user accounts and wallet balances

Agents API

Create and manage AI financial agents

Payments API

Process financial transactions

Transactions API

Track and analyze transaction history

Savings API

Manage interest-bearing investments

​
Authentication

All API endpoints require authentication using an API key. Your API key should be included in all requests as an HTTP header:
Security First: Your API key grants complete access to your Mage account. Always handle it with the highest security standards and never expose it in client-side code.

​
Base URL

All API requests should be made to:

​
Response Format

Consistent Structure: All API responses follow a consistent JSON structure to simplify integration and error handling in your applications.
All API responses are returned in JSON format. Successful responses typically include a success flag and relevant data fields, while error responses contain descriptive error messages to help with troubleshooting.

​
Error Handling

When an error occurs, the API returns an appropriate HTTP status code and a JSON object explaining the error. For detailed information about handling specific errors, please refer to the Error Handling documentation.

​
Status Codes Reference

​
Rate Limiting

Service Stability: Rate limits ensure reliable service for all users. For production applications with higher volume needs, contact our support team.
To ensure service stability, the Mage API implements rate limiting:
  • 100 requests per minute per API key
  • 5,000 requests per day per API key
For higher limits, please contact our support team.

​
Support

If you have any questions or need assistance with the API, you can: