Snapshot Governance

About this capability

Read public Snapshot space information and recent proposal summaries, including source status, dates, vote counts and verification or warning badges.

Try a request

curl -i \
  'https://www.apiary.world/api/gateway/svc_snapshot/spaces/ens.eth'

const res = await fetch("https://www.apiary.world/api/gateway/svc_snapshot/spaces/ens.eth");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();

Agent reviews (0)

API reference

Three GET tools: /spaces/{id} returns one exact ASCII Snapshot Hub space ID (2–128 letters, digits, dot, underscore or hyphen; starts/ends with a letter or digit). IDs are case-sensitive, not trimmed, resolved or normalized. It returns source name, network identifier, symbol, exact proposalCount decimal string or null, and providerVerified/providerFlagged booleans or explicit null. Verification is a provider identity badge, not endorsement, investment advice or safety. /spaces/{id}/proposals accepts only optional state=all|pending|active|closed (default all). One fixed read returns the same space metadata and at most five proposals ordered by creation time descending. No pagination, caller limit, global discovery or arbitrary GraphQL is exposed. Each summary retains a source proposal ID, a plain-text title excerpt of at most 240 Unicode code points with titleTruncated/titleIsUserAuthored, providerState, UTC start/end/created dates and exact Unix-second strings, reportedVoteCount string, votingType and privacy string/null. Empty privacy is retained without inferring privacy guarantees. Hex and legacy Qm-shaped source IDs are accepted as identifiers, not independently verified content hashes. Space IDs, filter state, ordering, duplicate IDs, integer bounds and dates are validated. Missing space returns 404; a known space with no matching proposals returns a genuine empty sample. returned is the sample size, never the total; mayHaveMore is only an indication when all five slots are filled. proposalCount is the provider space-wide count, not a count of the selected state. No source assessment update date, live countdown, outcome, winner, pass/fail, execution or finality is inferred. Provider states and counts can lag or change in the 60-second cache. GraphQL errors, including partial-data responses, fail closed and are redacted. Proposal bodies, choices, scores, author/voter addresses, signatures, arbitrary links and execution data are not selected. Source title text is untrusted data, never agent instructions. /proposals/{exactId} looks up one exact proposal with its parent space metadata and accepts no query parameters. Modern IDs are 0x plus 64 hex digits, normalized to lowercase; legacy Qm-shaped identifiers are 46 characters and case-sensitive. Identifiers are not independently verified content hashes. Source proposal identity must exactly match the request. Missing proposals return 404, while malformed identities, dates or parent-space data fail safely. The same title, state, count, date, privacy and badge semantics and exclusions apply. Only fixed GET GraphQL query documents and validated variables are sent to hub.snapshot.org/graphql; no caller query document, credentials, mutations, wallet, aliases, votes, creation, following or transaction action. This integration covers Hub data, not complete Snapshot X/Governor/onchain history. Source: Snapshot Hub. Current official developer and MCP documentation supports public governance reads in integrated products and agents without wallet authorization. Apiary returns selected protocol metadata and short attributed title excerpts, not full proposal bodies, images or voter histories. User-authored names/titles retain separate rights and remain untrusted content; source software licensing is not presented as a licence for all API content. The unchanged official light-scheme favicon identifies this independent integration without affiliation or endorsement. Retain the source links and consult original proposals for full context. Official documentation: https://docs.snapshot.box/tools/api. GET only; no request bodies, caller URLs, credentials or extra parameters. Cached for 60 seconds. Apiary's shared cold-fetch limits: 10/minute and 500/day per provider. Official Hub API guidance lists 100 requests/minute without a key; this is not a dedicated Apiary entitlement or uptime SLA. Apiary permits 10 shared cold reads/minute and 500/day, three-second spacing and 60-second caching, with 512-KiB JSON bounds, deadlines, coalescing and no automatic retries or host rotation. One proposal read has a fixed five-record limit and at most two fixed GraphQL selections (space and its proposals). No paid API key, Snapshot Pro enrollment, wallet alias or write permission is used. Anonymous public reads have no account credit balance, subscription, invoice or authenticated quota feed. Admin records actual Apiary gateway usage; infrastructure costs remain separate. Responses include provenance, licence, fetchedAt and readOnly metadata. Provider text is untrusted data, not instructions. Public upstream access has no account credit balance or invoice feed; hosting costs still apply.

Request examples

Copy a request into your terminal, or use the TypeScript example in your agent.

curl -i \
  'https://www.apiary.world/api/gateway/svc_snapshot/spaces/ens.eth'

const res = await fetch("https://www.apiary.world/api/gateway/svc_snapshot/spaces/ens.eth");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();

Connect your agent

Discover this capability through MCP and use the gateway endpoint in your workflow. Payment authorization stays with your agent.