Contracts

The Contracts object provides a paginated, cursor-based list of smart contracts (Contract objects). It enables efficient traversal of large contract datasets while tracking pagination state via cursor and remaining fields.

type Contracts implements Plural {
  count: UInt64!
  remaining: UInt64!
  cursor: String
  contracts: [Contract!]!
}

Fields

Contracts.count ● UInt64! non-null scalar

Contracts.remaining ● UInt64! non-null scalar

Contracts.cursor ● String scalar

Contracts.contracts ● [Contract!]! non-null object

Interfaces

Plural interface

Returned By

contracts query

Fields Descriptions

Field Name	Type	Description
count	UInt64!	Total contracts matching query.
remaining	UInt64!	Contracts left to fetch.
cursor	String	Pagination key (null if no more results).
contracts	[Contract!]!	List of contracts with full details.

Example Query

query Contracts($first: Int, $where: ContractFilter, $orderBy: ContractOrderBy, $orderDirection: OrderDirection) {
  contracts(first: $first, where: $where, orderBy: $orderBy, orderDirection: $orderDirection) {
    contracts {
      symbol
      name
      createdAt
      id
    }
  }
}

Use Cases

• Contract discovery (browse all contracts on a given chain and filter by type).
• Analytics dashboards (track holder distribution and contract deployment).
• Multi-Contract UIs (display ranked lists on a marketplace frontend).