API Reference

Complete reference for all API endpoints.

Base URL


https://YOUR_API_DOMAIN

Authentication

All endpoints require authentication via bearer token:


Authorization: Bearer YOUR_BEARER_TOKEN

Airdrop operations also require HMAC-SHA256 request signatures:


X-Signature: v1,t=timestamp,s=signature

See Authentication for details.

Endpoints

POST /api/airdrop - Process an airdrop transaction
GET /api/health - Check API health status
Transaction Verification - Verify transactions via RPC or explorer

Error Handling

All endpoints return consistent error responses:


{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {}
  },
  "timestamp": "2025-11-18T12:00:00Z"
}

See Error Codes for a complete list.

Response Format

Success Response


{
  "success": true,
  // ... endpoint-specific data
  "timestamp": "2025-11-18T12:00:00Z"
}

Error Response


{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Description of the error"
  },
  "timestamp": "2025-11-18T12:00:00Z"
}

Request IDs

Each request is assigned a unique ID returned in the X-Request-ID header. Include this ID when contacting Movement about a specific request.