Directly integrate with the Modexia Gateway from any environment. Our API is served securely over HTTPS.
https://api.modexia.software| POST | /register | Register a new user account |
| GET | /api/v1/user/me | Get your profile, wallet address, balance, and API key |
| POST | /api/v1/user/activate | Activate your agent wallet (creates a smart account) |
| POST | /api/v1/user/rotate-key | Generate a new API key (invalidates the old one immediately) |
| GET | /api/v1/user/faucet | Get test credits from the sandbox faucet |
| POST | /api/v1/agent/pay | Send a payment to a recipient address |
| GET | /api/v1/agent/transaction/:id | Poll the status (PENDING, COMPLETE) of a specific transaction |
| GET | /api/v1/agent/transactions | List all historical transactions for your wallet |
| POST | /api/v1/vault/open | Open a new pre-funded payment channel |
| POST | /api/v1/vault/consume | Execute a gasless, high-frequency micropayment off-chain |
| POST | /api/v1/vault/settle | Close a channel and settle the final balance on-chain |
| GET | /api/v1/vault/status/:channelId | Get the current remaining balance and usage of a channel |
| GET | /api/v1/vault/channels | List all payment channels for your agent |
| GET | /api/v1/vault/micro-transactions | List off-chain consume receipts for a specific channel |
| GET | /api/v1/agent/policy/:address | Read the current limits for an agent address |
| POST | /api/v1/agent/policy | Override spending limits for a specific agent |
| POST | /api/v1/user/policy | Set global default spending limits for all wallets |
Making a payment via raw HTTP POST. We recommend providing an idempotencyKey to safely retry failed network requests.
curl -X POST https://api.modexia.software/api/v1/agent/pay \
-H "x-modexia-key: mx_test_abc123..." \
-H "Content-Type: application/json" \
-d '{
"providerAddress": "0x742d35Cc6634C0532925a3b...",
"amount": "5.0",
"idempotencyKey": "unique-request-id-12345"
}'Response: 200 OK {"success": true, "txId": "..."}