API Reference

Programmatic access to ExecLens estimates. Pro tier required.

Authentication

All API requests require an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Pro Tier Only: API access is available for Pro and Team tier subscribers. Visit the Pricing page to upgrade.

Base URL

https://api.execlens.app/v1

Endpoints

POST/api/estimate

Get slippage and priority fee estimates for a token swap

Request Body

{
  "tokenIn": "SOL",
  "tokenOut": "USDC",
  "amount": 10,
  "mode": "normal" // "safe" | "normal" | "fast"
}

Response

{
  "slippage": {
    "safe": "1.5%",
    "normal": "0.8%",
    "fast": "0.3%"
  },
  "priorityFee": {
    "low": "0.00001",
    "normal": "0.00005",
    "aggressive": "0.0001"
  },
  "executionCondition": "Medium",
  "signals": [
    "Liquidity depth: Moderate",
    "Recent confirmations: 2.3s avg",
    "Network load: 65%"
  ],
  "timestamp": "2025-01-15T10:30:00Z"
}

GET/api/tokens

List supported tokens

Response

{
  "tokens": [
    {
      "symbol": "SOL",
      "name": "Solana",
      "address": "So11111111111111111111111111111111111111112"
    },
    {
      "symbol": "USDC",
      "name": "USD Coin",
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    }
  ]
}

GET/api/health

Check API health status

Response

{
  "status": "operational",
  "timestamp": "2025-01-15T10:30:00Z"
}

Rate Limits

Rate limits vary by tier. All responses include rate limit headers:

X-RateLimit-Limit - Maximum requests per hour
X-RateLimit-Remaining - Remaining requests in current window
X-RateLimit-Reset - Time when limit resets (Unix timestamp)

Free: 100 requests/hour

Pro: 1,000 requests/hour

Team: 10,000 requests/hour

Error Handling

The API returns standard HTTP status codes and error messages:

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Token 'XYZ' is not supported"
  }
}

400Bad Request - Invalid parameters

401Unauthorized - Invalid or missing API key

429Too Many Requests - Rate limit exceeded

500Internal Server Error - Contact support

Disclaimer

ExecLens API provides informational estimates only. We do not execute transactions or provide financial advice. All estimates are subject to market conditions.