/api/v1/options/vol-surface/by-expiry
GET /api/v1/options/vol-surface/by-expiry is an endpoint of the Laevitas API V2 API, listed on Proxygate by Laevitas. Vol Surface By Expiry AI agents call it per request through a transparent proxy and pay $0.0010 per request in USDC on Solana, with no subscription and no API key to manage.
$0.0010 / request
GET
USDC on Solana
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| end | string | No | End date for time-series mode in ISO 8601 format (UTC) |
| date | string | No | Exact date/time for a single snapshot in ISO 8601 format (UTC). If omitted and no start/end provided, returns the latest available snapshot. Mutually exclusive with start/end. |
| limit | number | No | Maximum number of distinct time buckets to return (1-1000). Only used in time-series mode (when start/end provided). |
| start | string | No | Start date for time-series mode in ISO 8601 format (UTC). When provided, returns paginated snapshots over time instead of a single snapshot. |
| cursor | string | No | Pagination cursor for fetching the next page of results. Use the value returned in meta.next_cursor from the previous response. Only used in time-series mode. |
| currency | string | Yes | Base currency (e.g., BTC, ETH). Required for vol-surface queries. |
| exchange | string | Yes | Exchange name (e.g., deribit, binance, okx, bybit, bullish, derive). Required. |
| sort_dir | string | No | Sort direction by time bucket (time-series mode only). ASC = oldest first (default). DESC = newest first. Keep sort_dir constant within a paginated scan. |
| resolution | string | No | Time resolution for aggregation. At 1m (default), returns raw minute-level data. At higher resolutions (5m, 1h, etc.), data is aggregated into the specified bucket. |
Call /api/v1/options/vol-surface/by-expiry with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy laevitas-api-v2 /api/v1/options/vol-surface/by-expiry -X GET// Call it from an AI agent over the Proxygate MCP server
call_api({
listing_id: "6df653d9-425e-44f8-81af-1f71681b2e84",
method: "GET",
path: "/api/v1/options/vol-surface/by-expiry"
})Laevitas API V2 /api/v1/options/vol-surface/by-expiry: frequently asked questions
Vol Surface By Expiry
It costs $0.0010 per request, settled in USDC on Solana. There is no subscription and no monthly minimum: an agent pays per call from a single prepaid balance.
The agent calls GET /api/v1/options/vol-surface/by-expiry through the Proxygate gateway with the Proxygate CLI, SDK, or MCP server. Proxygate routes the request to the upstream provider, injects the provider key server-side, and returns the response with a signed receipt.
No. The upstream provider key never leaves the Proxygate gateway. Your agent authenticates once to Proxygate; the key is injected server-side per request and is never shared with or exposed to the agent.