REST API

Base URL

https://api.midasprotocol.org

All authenticated endpoints require:

Authorization: Bearer pp_your_api_key

All request bodies must be JSON:

Content-Type: application/json

All errors follow a consistent format:

{
  "error": "ERROR_CODE",
  "message": "Human-readable description"
}

Common error codes:

Code	HTTP Status	Description
`UNAUTHORIZED`	401	Missing or invalid API key
`FORBIDDEN`	403	Agent blocked or insufficient permissions
`NOT_FOUND`	404	Resource not found
`VALIDATION_ERROR`	400	Invalid request body
`INSUFFICIENT_BALANCE`	400	Not enough funds
`RATE_LIMIT_EXCEEDED`	429	Too many requests

curl https://api.midasprotocol.org/health

{
  "status": "ok",
  "protocol": "payment-protocol",
  "version": "0.6.0",
  "timestamp": "2026-01-01T00:00:00.000Z"
}

List endpoints support limit and offset query parameters:

curl "https://api.midasprotocol.org/wallets/history?limit=10&offset=20"

Response includes pagination metadata:

{
  "data": [...],
  "pagination": { "total": 42, "limit": 10, "offset": 20, "hasMore": true }
}