# Gitcoin GraphQL API

The Gitcoin Grants Stack Indexer exposes a GraphQL API built with PostGraphile, which introspects a PostgreSQL database and auto-generates a fully-typed GraphQL schema from the underlying tables. The API provides read access to indexed on-chain grant round data sourced from the Allo Protocol and Gitcoin Grants Stack smart contracts across multiple EVM-compatible chains. Key queryable entities include funding rounds, project applications, donations, project metadata, round roles, and payout attestations. Filtering, pagination, and ordering are available on all collection queries through PostGraphile's standard connection pattern (nodes/edges/pageInfo) and direct list fields with `condition` and `filter` arguments. PostGraphile's ConnectionFilterPlugin is enabled, providing rich nested filtering operators.

Authentication is not required for read queries. The API is publicly accessible without an API key. The PostGraphile depth limit is set to 4 and cost limiting is disabled, making it suitable for exploratory and integration use. GraphQL mutations are not exposed; the indexer is a read-only projection of on-chain state. Data is indexed from supported EVM chains (Ethereum Mainnet, Optimism, Arbitrum, Polygon, Fantom, zkSync Era, Avalanche, and others) and updated in near-real-time as new blocks are processed.

The GraphQL schema is dynamically generated by PostGraphile from the PostgreSQL schema at startup and exported to `schema.graphql`. The primary tables exposed are: `projects`, `rounds`, `applications`, `donations`, `project_roles`, `round_roles`, `application_payouts`, `attestations`, and `prices`. PostGraphile's PgSimplifyInflectorPlugin is applied, converting snake_case column names to camelCase in the GraphQL API. The GraphiQL interactive explorer is available at the `/graphiql` route.

**Endpoint:** https://grants-stack-indexer-v2.gitcoin.co/graphql

**GraphiQL Explorer:** https://grants-stack-indexer-v2.gitcoin.co/graphiql

**Documentation:**
- Documentation: https://docs.allo.gitcoin.co/
- GettingStarted: https://docs.gitcoin.co/

**References:**
- Documentation: https://docs.allo.gitcoin.co/
- GettingStarted: https://docs.gitcoin.co/
- GitHubRepository: https://github.com/gitcoinco/grants-stack-indexer
- GraphiQL: https://grants-stack-indexer-v2.gitcoin.co/graphiql