/v1/reference/candles
GET /v1/reference/candles is an endpoint of the MarketLens Data API API, listed on Proxygate by Proxygate. List reference price candles AI agents call it per request through a transparent proxy and pay Free per request in USDC on Solana, with no subscription and no API key to manage.
Free / request
GET
USDC on Solana
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| after | - | No | Only candles at or after this time (inclusive, ms epoch). |
| limit | integer | No | Max results per page. |
| order | string | No | Sort direction by timestamp: asc or desc. |
| before | - | No | Only candles before this time (exclusive, ms epoch). |
| cursor | - | No | Opaque cursor for the next page. |
| symbol | string | Yes | Underlying symbol (e.g. BTC, ETH, SOL). |
| api_key | - | No | - |
| resolution | string | No | Bucket size: 1s, 5s, 10s, 30s, 1m, 5m, 15m, 1h, 4h, 1d. |
Call /v1/reference/candles with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy marketlens-data-api /v1/reference/candles -X GET// Call it from an AI agent over the Proxygate MCP server
call_api({
listing_id: "61a5e10e-14c9-4f60-9aaf-374a5884715c",
method: "GET",
path: "/v1/reference/candles"
})MarketLens Data API /v1/reference/candles: frequently asked questions
List reference price candles
It costs Free 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 /v1/reference/candles 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.