/api/v1/perpetuals/trades
GET /api/v1/perpetuals/trades is an endpoint of the Laevitas API V2 API, listed on Proxygate by Laevitas. Perpetuals Trade History 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 in ISO 8601 format (UTC) |
| sort | string | No | Sort field. Default: timestamp. |
| limit | number | No | Maximum number of records to return (1-1000) |
| start | string | No | Start date in ISO 8601 format (UTC). Defaults to 24 hours ago when omitted. |
| top_n | number | No | Return top N trades by the sort field (DESC). Overrides limit and sort_dir. No pagination cursor returned. |
| cursor | string | No | Pagination cursor for fetching the next page of results. Use the value returned in meta.next_cursor from the previous response. |
| currency | string | No | Base currency (e.g. BTC, ETH). Returns trades across ALL perpetuals for this currency. Either currency or instrument_name is required. |
| exchange | string | No | Exchange name (e.g., deribit, binance) |
| sort_dir | string | No | Sort direction. Defaults to ASC for instrument mode, DESC for currency mode. |
| strategy | string | No | Filter by strategy label. Accepts comma-separated values (e.g. calendar_spread). |
| direction | string | No | Filter by trade direction (aggressor side) |
| block_only | boolean | No | If true, only return trades with a block_trade_id (block trades). |
| min_amount | number | No | Minimum trade amount (in contracts). Filters out dust trades. |
| instrument_name | string | No | Full perpetual instrument identifier (e.g., BTC-PERPETUAL). Either instrument_name or currency is required. |
Call /api/v1/perpetuals/trades with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy laevitas-api-v2 /api/v1/perpetuals/trades -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/perpetuals/trades"
})Laevitas API V2 /api/v1/perpetuals/trades: frequently asked questions
Perpetuals Trade History
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/perpetuals/trades 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.