Skip to main content
All endpoints scoped to a project accept a slug query parameter. Endpoints scoped to a specific proposal use a {publicKey} path parameter — the proposal’s onchain public key.

GET /v1/proposal

Returns all proposals for a project. Parameters: slug (required), limit, page

GET /v1/proposal/filter

Returns a minimal list of proposals (id + title only) for a project. Useful for building dropdowns or search interfaces. Parameters: slug (required)
Do not pass limit or page to this endpoint — they are not supported and will return a 400 error.

GET /v1/proposal/analytics

Returns aggregate proposal outcome counts for a project. Parameters: slug (required)

GET /v1/proposal/

Returns full detail for a single proposal. Parameters: publicKey (path, required)

GET /v1/proposal//orders

Returns individual trades for a specific proposal. Parameters: publicKey (path, required), limit, page

GET /v1/proposal//orders/csv

Returns all orders for a proposal as a CSV file download. Parameters: publicKey (path, required)
CSV exports are not available on every plan. If your plan does not include this endpoint, it returns 403.
Returns a text/csv file with the same fields as /v1/proposal/{publicKey}/orders. Use -o to save to a file.

GET /v1/proposal//orders/unique-traders/csv

Returns the list of unique trader wallet addresses for a proposal as a CSV file download. Parameters: publicKey (path, required)
CSV exports are not available on every plan. If your plan does not include this endpoint, it returns 403.
Returns a text/csv file with one wallet address per row.

GET /v1/proposal//orders/volume/csv

Returns aggregated order volume data for a proposal as a CSV file download. Parameters: publicKey (path, required)
CSV exports are not available on every plan. If your plan does not include this endpoint, it returns 403.
Returns a text/csv file with volume breakdown by market type and direction.

GET /v1/proposal//price-chart

Returns 15-minute OHLC price and TWAP data for both pass and fail markets over the proposal’s lifetime. Parameters: publicKey (path, required)

GET /v1/proposal//market-overview

Returns a summary of market activity for a proposal. Parameters: publicKey (path, required)

GET /v1/proposal//proposal-for-chart

Returns metadata needed to render proposal status and staking progress charts. Parameters: publicKey (path, required)

GET /v1/proposal//threshold-chart

Returns TWAP pass-edge data over the TWAP observation window. Parameters: publicKey (path, required), timeInterval (required: 15m, 1h, 4h, 1d, max)
timeInterval is required. Valid values are 15m, 1h, 4h, 1d, max. Omitting it returns a 400 error.

GET /v1/proposal//flow-chart

Returns cumulative and interval-level net pass volume tilt over time. Parameters: publicKey (path, required), timeInterval (required: 15m, 1h, 4h, 1d, max)
timeInterval is required. Valid values are 15m, 1h, 4h, 1d, max.

GET /v1/proposal//pass-edge

Returns the final TWAP pass edge and outcome classification for a resolved proposal. Parameters: publicKey (path, required)

GET /v1/proposal/analytics//trade-overview

Returns trader composition statistics for a specific proposal. Parameters: publicKey (path, required)

GET /v1/proposal/analytics//outcome-strength

Returns a detailed breakdown of trader and volume alignment toward each outcome. Parameters: publicKey (path, required)

GET /v1/proposal/analytics//conviction-chart

Returns hourly net pass-aligned capital flow over the proposal’s lifetime. Parameters: publicKey (path, required)

GET /v1/proposal/analytics//trade-frequency-chart

Returns a histogram of how many trades each trader placed on this proposal. Parameters: publicKey (path, required)
Each key is a trade-count bucket. The value is the number of traders who placed that many trades. Useful for distinguishing passive vs. active traders.

GET /v1/proposal/filter//traders

Returns the list of trader wallet addresses for a specific proposal. Parameters: publicKey (path, required)
Returns a flat list of all wallets that placed at least one trade on this proposal.

GET /v1/proposal/comparable//proposal-metrics-chart

Compares this proposal’s key metrics against the median across all comparable proposals for the same project. Parameters: publicKey (path, required), slug (query, required)
Both publicKey (path) and slug (query) are required. Omitting slug returns a 400 error.

GET /v1/proposal/analytics/proposal-comparables

Returns the pool of comparable proposals used for benchmark calculations for a project. Parameters: slug (required)

GET /v1/trading-activity/

Returns aggregate decision market trading statistics for a project. Parameters: daoSlug (path, required)

GET /v1/trading-activity//trading-activities

Returns all individual trades across all proposals for a project, most recent first. Parameters: daoSlug (path, required), limit, page