GET

/v1/markets

GET /v1/markets is an endpoint of the MarketLens Data API API, listed on Proxygate by Proxygate. List markets 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.

Price

Free / request

Method

GET

Settlement

USDC on Solana

Parameters

ParameterTypeRequiredDescription
q-NoFull-text search on the market question (min 3 chars).
sort-NoSort field with optional '-' prefix for descending. Options: created_at, close_time, volume, liquidity, resolved_at. Default: -created_at.
limitintegerNoMax results per page.
cursor-NoOpaque cursor from a previous response's meta.cursor for the next page.
status-NoFilter by market status: active, closed, resolved, or pending.
api_key-No-
event_q-NoFull-text search on the parent event title (min 3 chars).
category-NoFilter by topic category (e.g. 'Crypto', 'Politics').
event_id-NoFilter to markets belonging to this event UUID.
platform-NoFilter by source platform (e.g. 'polymarket').
recurring-NoTrue = only recurring-series markets, False = only standalone.
series_id-NoFilter to markets belonging to this series UUID.
min_volume-NoMinimum cumulative volume in USD.
open_after-NoMarkets that opened at or after this time (ms epoch).
close_after-NoMarkets closing at or after this time (ms epoch).
open_before-NoMarkets that opened at or before this time (ms epoch).
close_before-NoMarkets closing at or before this time (ms epoch).
condition_id-NoOne or more platform-native condition IDs (comma-separated or repeated). Max 50.
min_liquidity-NoMinimum current liquidity in USD.
resolved_after-NoMarkets resolved at or after this time (ms epoch).
resolved_before-NoMarkets resolved at or before this time (ms epoch).

Call /v1/markets with an AI agent

Proxygate CLI
# Call this endpoint with the Proxygate CLI
proxygate proxy marketlens-data-api /v1/markets -X GET
MCP / agent
// Call it from an AI agent over the Proxygate MCP server
call_api({
  listing_id: "61a5e10e-14c9-4f60-9aaf-374a5884715c",
  method: "GET",
  path: "/v1/markets"
})

MarketLens Data API /v1/markets: frequently asked questions

List markets

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/markets 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.