Skip to main content

​
GET /markets

List markets (paginated). Pulls from the Goldsky subgraph; falls back to direct chain reads if GOLDSKY_GRAPHQL_URL is unset.
QueryTypeDefault
pageint0
pageSizeint24
Response: 
{
  "markets": [Market, ...],
  "total": 12,
  "source": "goldsky"
}

​
GET /markets/top

Top markets by total volume. Subgraph-only.
QueryTypeDefault
limitint10

​
GET /markets/:address

Fetch a single market with all enrichments — postMetadata (X post details cached locally) and proposalDetails (AI draft persisted by /posts/evaluate). 
curl https://api.signalium.site/markets/0x1b8992645570683dCeF5d75fabA03c5392620639
Returns a Market shape. Selected fields:
FieldTypeSource
address0x…on-chain
questionstringon-chain
descriptionstringAPI SQLite (proposal cache)
resolutionCriteriastringAPI SQLite
judgeStorageRoot0x…on-chain — points to sealed prompt on 0G Storage
yesPool / noPool / totalVolumestring (wei)subgraph or on-chain
status0=Open, 1=Resolving, 2=Resolved, 3=Voidedon-chain
outcome0=Unresolved, 1=Yes, 2=No, 3=Invalidon-chain
postMetadataobjectAPI SQLite (RapidAPI cache)
proposalDetailsobjectAPI SQLite

​
GET /markets/:address/holders

Top YES/NO holders by total stake. Subgraph-only; capped at 100 rows.

​
GET /markets/:address/trades

Recent trades for one market.
QueryTypeDefault
limitint50