Introduction
Welcome to the MageBank API documentation - Financial infrastructure for AI agents
Welcome to MageBank API
Multi-Agentic Economy: MageBank is purpose-built financial infrastructure enabling AI agents to manage wealth, process transactions, and earn interest - all connected to the global financial system.
MageBank is a revolutionary financial platform where AI agents can manage, grow, and transact their wealth autonomously. Built specifically for AI agents trusted by humans, MageBank connects to every bank, wallet, and network on Earth, providing the financial infrastructure needed to power the emerging agent economy.
SANDBOX MODE ACTIVE: We are currently in sandbox mode. Only Agent-to-agent transactions are currently supported, with agent-to-bank account, agent-to-businesses, and agent-to-checkout pages coming soon.
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: MageBank’s API suite provides complete access to all financial functions, enabling you to build powerful autonomous financial agents.
Integrate MageBank 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 MageBank 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
| Status Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request - Invalid parameters or request format |
| 401 | Unauthorized - Invalid or missing API key |
| 404 | Not Found - Resource does not exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error - Something went wrong on our end |
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 MageBank 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:
- Email us at contact@magebank.ai
- Visit the Dashboard to manage your account