Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

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

The polygon.predictions.trades table provides comprehensive trade data from prediction market platforms on Polygon. Currently featuring Polymarket data, this schema is designed to seamlessly integrate additional prediction market protocols as they become available. Use this table to analyze trading patterns, market volumes, participant behavior, and event outcomes across prediction markets on Polygon.

​
Table Columns

Data Precision Notes:
  • _raw fields contain unnormalized amounts for maximum precision
  • _str columns are numeric fields cast to varchar to retain precision
  • USD amounts reflect value at time of trade
Unique Key: unique_id
Column NameData TypeDescription
event_nameVARCHARName of the prediction market event.
projectVARCHARName of the project (e.g., Polymarket).
protocolVARCHARProtocol name (e.g., polymarket).
exchange_typeVARCHARType of exchange (e.g., Polymarket Fixed Product Market Maker, Orderbook).
condition_idVARCHARUnique identifier for the event condition.
market_addressVARCHARAddress of the prediction market contract.
order_hashVARCHARUnique hash of the order.
makerVARCHARAddress of the maker in the trade.
takerVARCHARAddress of the taker in the trade.
asset_idVARCHARIdentifier for the traded asset.
collateral_amount_rawVARCHARRaw collateral amount (unnormalized).
token_amount_rawVARCHARRaw share amount (unnormalized).
price_strVARCHARShare price as a string.
priceFLOATShare price as a float.
maker_amount_rawVARCHARRaw amount provided by the maker.
taker_amount_rawVARCHARRaw amount provided by the taker.
fee_rawVARCHARRaw fee amount.
collateral_token_addressVARCHARAddress of the collateral token.
collateral_token_nameVARCHARName of the collateral token.
collateral_token_symbolVARCHARSymbol of the collateral token.
collateral_token_decimalsNUMBERDecimals of the collateral token.
collateral_amountVARCHARCollateral amount (normalized).
fee_amountVARCHARFee amount (normalized).
usd_exchange_rateFLOATUSD exchange rate of the collateral token at the time of trade.
usd_collateral_amountFLOATCollateral amount in USD.
usd_fee_amountFLOATFee amount in USD.
transaction_indexNUMBERIndex of the transaction in the block.
transaction_hashVARCHARHash of the transaction.
log_indexNUMBERLog index of the trade event.
block_timestampTIMESTAMP_NTZ(9)Timestamp of the block containing the trade.
block_numberNUMBERBlock number of the trade.
block_hashVARCHARHash of the block containing the trade.
unique_idVARCHARUnique identifier for the trade.
_created_atTIMESTAMP_NTZ(9)The timestamp of the creation of the trade.
_updated_atTIMESTAMP_NTZ(9)The timestamp of the last update of the trade.

​
Sample Queries

Get recent prediction market trades with essential details:
select
  event_name,
  project,
  price,
  usd_collateral_amount,
  maker,
  taker,
  block_timestamp
from polygon.predictions.trades
where block_timestamp >= current_timestamp - interval '3 days'
order by block_timestamp desc

​
Protocol Coverage

ProtocolStatusExchange Types Supported
Polymarket✅ ActiveFixed Product Market Maker, Orderbook
More protocols will be added as they launch or integrate with Polygon.