Public API Overview

Base URL, endpoint summary, pagination, and Python examples for public REST endpoints

Use public endpoints for read-only market data.

Base URL

https://api.outpoll.com

Use HTTPS for every request.

Authentication

No authentication required.

Common errors

Code	Description
200	OK — Request succeeded
400	Bad Request — Invalid parameters
404	Not Found — Resource does not exist
500	Internal Server Error

Error response

{
  "status": 400,
  "error": "Bad Request",
  "message": "Invalid parameters"
}

Available endpoints

• Get Available Coins — supported assets and coin metadata

• Search Events — market discovery with filters and pagination

• Get Categories — category tree for events

• Get Popular Tags — trending tags for discovery

Python quickstart

Install the HTTP client first.

pip install requests

Use a shared session and always set a timeout.

public_api.py

import requests

BASE_URL = "https://api.outpoll.com"
TIMEOUT = 10

session = requests.Session()


def get_json(method: str, path: str, **kwargs):
    response = session.request(
        method=method,
        url=f"{BASE_URL}{path}",
        timeout=TIMEOUT,
        **kwargs,
    )
    response.raise_for_status()
    return response.json()

Python examples

Get available coins

Use this endpoint to fetch supported assets.

GET /api/coins

get_coins.py

coins = get_json("GET", "/api/coins")

for coin in coins:
    print(f"{coin['sn']}: {coin['n']} | rate={coin['ur']}")

Search events

Use this endpoint to browse markets.

POST /api/events/search

search_events.py

payload = {
    "sb": "VOLUME_24H",
    "sd": "DESC",
    "l": "en",
    "ss": "bitcoin",
}

params = {
    "page": 0,
    "size": 20,
}

data = get_json(
    "POST",
    "/api/events/search",
    params=params,
    json=payload,
)

for event in data["content"]:
    print(f"{event['i']} | {event['ti']}")

Get categories

Use this endpoint to build filters or navigation.

GET /api/categories

get_categories.py

categories = get_json("GET", "/api/categories")

for category in categories:
    print(f"{category['n']} ({category['s']})")

Get popular tags

Use this endpoint to surface trending topics.

GET /api/tags/popular

get_popular_tags.py

tags = get_json(
    "GET",
    "/api/tags/popular",
    params={"limit": 10},
)

for tag in tags:
    print(f"#{tag['r']} {tag['n']}")

Pagination

Paginated endpoints accept these query parameters:

• page — zero-based page number

• size — number of items per page

Typical paginated responses include:

• content — current page items

• totalElements — total matching items

• totalPages — total page count

Python example: iterate through pages

paginate_events.py

page = 0

while True:
    data = get_json(
        "POST",
        "/api/events/search",
        params={"page": page, "size": 50},
        json={"sb": "NEWEST", "sd": "DESC", "l": "en"},
    )

    for event in data["content"]:
        print(event["ti"])

    page += 1
    if page >= data["totalPages"]:
        break

Next pages

Use the detailed endpoint pages when you need full request and response schemas:

• Get Available Coins

• Search Events

• Get Categories

• Get Popular Tags