Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.signalium.site/llms.txt

Use this file to discover all available pages before exploring further.

Base URL — production: https://api.signalium.site · local: http://localhost:3001 All responses are JSON. CORS is permissive (*) so the deployed web app can hit the same origin you’re testing against.

​
Endpoint groups

GroupPurpose
/marketsList, paginate, fetch detail, holders, trades
/postsEvaluate an X URL — runs gatekeeper + writer in 0G Compute TEE
/usersA wallet’s positions and trade history
/priceCached 0G/USD price (CoinGecko, refreshed every 6h)
/healthLiveness + subgraph indexer lag

​
Caching strategy

The API keeps a small SQLite (apps/api/data/signalium.db) for three hot paths:
  • X post metadata — fetched once via RapidAPI’s twitter241, then served from disk.
  • AI proposals — written when /posts/evaluate returns an eligible draft, keyed by the judgeStorageRoot merkle root that ends up on-chain.
  • 0G/USD price — refreshed at most every 6 hours; serves stale on upstream failure.
The same SQLite is what lets /markets/:address return the rich description, resolutionCriteria, and proposalDetails block that the on-chain market doesn’t carry.