Open Query API

The Open Query API is Eurybia's read-only data query layer. It serves raw and cleaned on-chain, social and market data to external partners.

Property	Value
Framework	FastAPI
Base URL	https://eurybia.xyz/api/open/query
Auth	X-API-Key header
Data stores	PostgreSQL (multi-database) + ClickHouse (historical)
Interactive reference	Open Query API reference

Authentication

Every public endpoint requires an API key passed in the X-API-Key header:

curl -H "X-API-Key: <your_api_key>" \
  "https://eurybia.xyz/api/open/query/twitter/users?limit=10"

Self-service key application

Apply for an API key at POST /api/open/query/auth/apply. The payload is encrypted with a shared secret and the response contains an encrypted payload that must be decrypted locally to retrieve the usable API key.

Rate limiting & caching

• Requests are rate-limited per API key (configurable profile per key).
• Responses are cached with a short TTL (default 15s; 60s for history endpoints).
• Time-range queries must pass from_time / to_time validation.

Endpoint groups

Twitter

Endpoint	Description
GET /twitter/users	Curated Twitter/X user profiles
GET /twitter/address-mentions	Tweets mentioning crypto addresses
GET /twitter/alpha-mentions	Tweets mentioning alpha tokens/symbols
GET /twitter/sentiment-15m/accounts	15-minute sentiment per account
GET /twitter/raw-tweets	Raw tweets (MongoDB-backed)
GET /twitter/hourly-summaries	Hourly sentiment summaries

Telegram

Endpoint	Description
GET /telegram/group-messages	Group messages
GET /telegram/channel-updates	Channel updates

News

Endpoint	Description
GET /news/hourly-summaries	Hourly news summaries

Market

Endpoint	Description
GET /market/ohlcv	OHLCV candles
GET /market/assets/snapshots	Asset snapshots

Solana

Endpoint	Description
GET /solana/tokens	Solana tokens
GET /solana/memecoin-ratings	Memecoin ratings
GET /solana/token-prices	Token prices

History (ClickHouse)

Endpoint	Description
GET /history/blockchain/ethereum/receipts	Ethereum transaction receipts
GET /history/blockchain/ethereum/logs	Ethereum logs
GET /history/blockchain/bitcoin/blocks	Bitcoin blocks
GET /history/market/dex/uniswap-v2-trades	Uniswap V2 trades
GET /history/stablecoins/ethereum/usdt-supply	USDT supply history
GET /history/social/base/friendtech-trades	Friend.tech trades

Ask KOL

Endpoint	Description
GET /ask/kols	List available KOL personas
GET /ask/{handle}	Chat with a KOL persona (LLM-powered)

Auth

Endpoint	Description
POST /auth/apply	Self-service API key application

Frontend BFF (/api/frontend/*)

The same service also hosts an internal BFF for the eurybia.xyz dashboard under /api/frontend (keyless, CORS-restricted). It is not part of the public partner API surface but is listed here for completeness.

Full interactive reference: Frontend BFF API reference.

Domain	Endpoints
CMC	/api/frontend/cmc/latest/rows, /cmc/timeseries, /cmc/big_number, /cmc/treemap, /cmc/weekly_growth/{kind}/rows, /cmc/rank_change/{kind}/rows
GameFi / SocialFi	/api/frontend/ch/gamefi/big, /ch/socialfi/big, /ch/socialfi/timeseries, /ch/socialfi/table/{kind}/rows
Web3	/api/frontend/web3/{game}/top/{col}/rows, /web3/{game}/dist/{col}/snapshot, /web3/{game}/json-timeseries
DAO	/api/frontend/dao/market/big
ClickHouse generic	/api/frontend/ch/{table}, /ch/{table}/rows
Stablecoin	/api/frontend/stablecoin/news/rows, /stablecoin/supply, /stablecoin/share
Solana	/api/frontend/solana/meme_wordcloud, /solana/meme_5days_t0_trend
Twitter	/api/frontend/twitter/keywords_wordcloud, /twitter/top10_volume, /twitter/price_sentiment
Quant	/api/frontend/quant/strategy_big
Media	/api/frontend/media/news_wordcloud, /media/news_rating
Ask / Plaza	/api/frontend/ask/kols, /ask/match, /ask/auto, /ask/stream/{handle}, /ask/comment/{handle}, /ask/conclude, /ask/{handle}, /plaza/posts
Generic table	/api/frontend/{domain}/{table}, /{domain}/{table}/rows, /{domain}/{table}/snapshot