Datasets Endpoint
GET /v1/datasets/{exchange}/{dataset}
Download metadata datasets. Returns a redirect to a pre-signed download URL.
No Authentication Required
This endpoint is publicly accessible and does not require an API key.
Updated Daily
Datasets are regenerated daily after midnight UTC. They are not real-time.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
exchange | string | Yes | Exchange name (e.g., polymarket) |
dataset | string | Yes | Dataset name (see below) |
Available Datasets
| Dataset | Description | Schema |
|---|---|---|
markets | Market metadata (slug, question, outcomes, etc.) | Markets Schema |
tags | Tag definitions for market categorization | Tags Schema |
Response
Success (302 Redirect)
Returns an HTTP 302 redirect to a pre-signed S3 URL. The file is in Apache Parquet format.
Errors
| Status | Error | Description |
|---|---|---|
404 | Not Found | Unknown exchange or dataset |
Examples
Download with curl
curl -L "https://api.telonex.io/v1/datasets/polymarket/markets" -o markets.parquet
Download with Python
import pandas as pd
df = pd.read_parquet("https://api.telonex.io/v1/datasets/polymarket/markets")
print(f"Found {len(df)} markets")
Using the Python SDK
from telonex import get_markets_dataframe
df = get_markets_dataframe(exchange="polymarket")
print(df[['slug', 'question']].head())