### Member Example

Source: https://apidocs.tally.xyz/index

An example of the Member structure, linking an account to an organization.

```json
{
  "id": "4",
  "account": Account,
  "organization": Organization
}
```

--------------------------------

### ProposalsSortInput Example

Source: https://apidocs.tally.xyz/index

An example of the ProposalsSortInput structure, used to specify sorting order and criteria for proposals.

```json
{"isDescending": true, "sortBy": "id"}
```

--------------------------------

### GovernorsSortInput Example

Source: https://apidocs.tally.xyz/index

An example of the GovernorsSortInput structure, specifying sorting direction and the field to sort by.

```json
{"isDescending": false, "sortBy": "id"}
```

--------------------------------

### String Example

Source: https://apidocs.tally.xyz/index

Example of a String scalar type, representing textual data.

```json
"xyz789"
```

--------------------------------

### Example Data Structure

Source: https://apidocs.tally.xyz/index

This snippet shows an example of a basic data structure with 'value' and 'summary' fields.

```json
{
  "value": "abc123",
  "summary": "xyz789"
}
```

--------------------------------

### ProposalsInput Example

Source: https://apidocs.tally.xyz/index

An example of the ProposalsInput structure, used for filtering and paginating proposals. It includes fields for filters, page, and sorting preferences.

```json
{
  "governorId": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "includeArchived": false,
  "isDraft": false,
  "organizationId": 2207450143689540900,
  "proposer": "0x1234567800000000000000000000000000000abc"
}
```

--------------------------------

### ChainID Type Example

Source: https://apidocs.tally.xyz/index

Shows an example of a ChainID, conforming to the CAIP-2 standard.

```string
"eip155:1"
```

--------------------------------

### GovernorsInput Example

Source: https://apidocs.tally.xyz/index

An example of the GovernorsInput structure, which aggregates filters, pagination, and sorting information for governance queries.

```json
{
  "filters": GovernorsFiltersInput,
  "page": PageInput,
  "sort": GovernorsSortInput
}
```

--------------------------------

### Chain Structure Example

Source: https://apidocs.tally.xyz/index

Provides an example of the Chain data structure, including its ID, name, native currency, and other properties. Note that chain data is loaded on server startup.

```json
{
  "id": "eip155:1",
  "layer1Id": "eip155:1",
  "name": "Ethereum Mainnet",
  "mediumName": "Ethereum",
  "shortName": "eth",
  "blockTime": 12,
  "isTestnet": false,
  "nativeCurrency": "ETH",
  "chain": "ETH",
  "useLayer1VotingPeriod": false
}
```

--------------------------------

### TokenType Example

Source: https://apidocs.tally.xyz/index

Example of a TokenType enumeration, specifying different types of tokens.

```json
"ERC20"
```

--------------------------------

### NativeCurrency Example

Source: https://apidocs.tally.xyz/index

An example of the NativeCurrency structure, providing details about a cryptocurrency such as its name, symbol, and decimal places.

```json
{
  "name": "abc123",
  "symbol": "xyz789",
  "decimals": 123
}
```

--------------------------------

### Timestamp Example

Source: https://apidocs.tally.xyz/index

Example of a Timestamp, represented as a RFC3339 string.

```json
1663224162
```

--------------------------------

### Tally API - Chains Response Example

Source: https://apidocs.tally.xyz/index

This JSON response provides an example of the data returned when querying for chains. It includes details for Ethereum Mainnet, such as its ID, name, native currency, and other relevant chain information.

```JSON
{
  "data": {
    "chains": [
      {
        "id": "eip155:1",
        "layer1Id": "eip155:1",
        "name": "Ethereum Mainnet",
        "mediumName": "Ethereum",
        "shortName": "eth",
        "blockTime": 12,
        "isTestnet": false,
        "nativeCurrency": "ETH",
        "chain": "ETH",
        "useLayer1VotingPeriod": true
      }
    ]
  }
}
```

--------------------------------

### Contract Structure Example

Source: https://apidocs.tally.xyz/index

Provides a comprehensive example of the Contract structure, including its ID, chain ID, creator address, name, type, and more. It also shows related fields like tx_hash and implementation_contract_id.

```json
{
  "id": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "organization_id": "4",
  "chain_id": "eip155:1",
  "block_id": BlockID,
  "tx_hash": "0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855",
  "creator_address": "0x1234567800000000000000000000000000000abc",
  "name": "xyz789",
  "abi": "xyz789",
  "type": "staker",
  "is_proxy": false,
  "implementation_contract_id": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "start_block": 987,
  "created_at": 1663224162,
  "updated_at": 1663224162
}
```

--------------------------------

### Issue Example

Source: https://apidocs.tally.xyz/index

An example of the Issue structure, containing details about an issue including its ID, organization, name, and description.

```json
{
  "id": 2207450143689540900,
  "organizationId": 2207450143689540900,
  "name": "xyz789",
  "description": "abc123"
}
```

--------------------------------

### Block Structure Example

Source: https://apidocs.tally.xyz/index

Provides an example of a Block object, containing its ID, number, and timestamps.

```json
{
  "id": BlockID,
  "number": 1553735115537351,
  "timestamp": 1663224162,
  "ts": 1663224162
}
```

--------------------------------

### HashID Example

Source: https://apidocs.tally.xyz/index

An example of a HashID, a ChainID-scoped identifier for transactions across different chains.

```json
"eip155:1:0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855"
```

--------------------------------

### Tally API - Get Account Data

Source: https://apidocs.tally.xyz/index

This snippet shows an example JSON response containing account data, including user ID, address, ENS name, Twitter handle, name, bio, picture, associated safes, account type, votes, and proposals created count.

```JSON
{
  "data": {
    "accounts": [
      {
        "id": "4",
        "address": "0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
        "ens": "tallyxyz.eth",
        "twitter": "@tallyxyz",
        "name": "Tally",
        "bio": "Now accepting delegations!",
        "picture": "https://static.tally.xyz/logo.png",
        "safes": [
          "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc"
        ],
        "type": "EOA",
        "votes": 10987654321,
        "proposalsCreatedCount": 123
      }
    ]
  }
}
```

--------------------------------

### Hash Example

Source: https://apidocs.tally.xyz/index

An example of a transaction hash, used for identifying transactions on a blockchain.

```json
"0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855"
```

--------------------------------

### Assignment Structure Example

Source: https://apidocs.tally.xyz/index

Illustrates the structure of an Assignment, which includes an account, an amount, and a percentage.

```json
{
  "account": Account,
  "amount": 10987654321,
  "percent": 987.65
}
```

--------------------------------

### OnchainVote Example

Source: https://apidocs.tally.xyz/index

An example of the OnchainVote structure, detailing an on-chain vote with its ID, amount, block information, proposal, voter, and transaction hash.

```json
{
  "id": 2207450143689540900,
  "amount": 10987654321,
  "block": Block,
  "chainId": "eip155:1",
  "isBridged": true,
  "proposal": Proposal,
  "reason": "xyz789",
  "type": "abstain",
  "txHash": "0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855",
  "voter": Account
}
```

--------------------------------

### Tally API Authentication Header

Source: https://apidocs.tally.xyz/index

Example of the required API key header for authentication with the Tally API.

```text
Api-Key: YOUR_KEY_HERE
```

--------------------------------

### Int Example

Source: https://apidocs.tally.xyz/index

An example of the Int scalar type, representing a signed whole numeric value.

```json
123
```

--------------------------------

### Node Union Example

Source: https://apidocs.tally.xyz/index

An example indicating a type within the Node union, which represents a union of all paginated node types.

```json
Delegate
```

--------------------------------

### Account Type Example

Source: https://apidocs.tally.xyz/index

Provides an example of the Account data structure, including fields like ID, address, ENS, Twitter handle, name, bio, picture, associated safes, account type, vote count, and proposals created count.

```JSON
{
  "id": "4",
  "address": "0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "ens": "tallyxyz.eth",
  "twitter": "@tallyxyz",
  "name": "Tally",
  "bio": "Now accepting delegations!",
  "picture": "https://static.tally.xyz/logo.png",
  "safes": [
    "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc"
  ],
  "type": "EOA",
  "votes": 10987654321,
  "proposalsCreatedCount": 987
}
```

--------------------------------

### Address Type Example

Source: https://apidocs.tally.xyz/index

Demonstrates the format of an Ethereum address, which is a 20-byte hexadecimal string prefixed with '0x'.

```string
"0x1234567800000000000000000000000000000abc"
```

--------------------------------

### Contracts Structure Example

Source: https://apidocs.tally.xyz/index

Illustrates the Contracts structure, which contains a governor contract and a list of token contracts.

```json
{
  "governor": GovernorContract,
  "tokens": [TokenContract]
}
```

--------------------------------

### IntID Example

Source: https://apidocs.tally.xyz/index

An example of the IntID scalar type, representing a 64-bit integer as a string to accommodate larger values than standard JavaScript numbers.

```json
2207450143689540900
```

--------------------------------

### StakeEarning Example

Source: https://apidocs.tally.xyz/index

Details of stake earnings, including principal, earnings, total value, and date.

```json
{
  "principal": 10987654321,
  "earnings": 10987654321,
  "amount": 10987654321,
  "totalValue": 10987654321,
  "date": "2022-09-22"
}
```

--------------------------------

### NewVoteType Example

Source: https://apidocs.tally.xyz/index

An example value for NewVoteType, specifying the category of a vote, such as 'onchain' or 'veto'.

```json
"onchain"
```

--------------------------------

### ContractType Enum Example

Source: https://apidocs.tally.xyz/index

Shows an example of the ContractType enumeration, with possible values like 'staker', 'unistaker', etc.

```string
"staker"
```

--------------------------------

### AssetID Type Example

Source: https://apidocs.tally.xyz/index

Shows an example of an AssetID, which follows the CAIP-19 standard for identifying blockchain assets.

```string
"eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f"
```

--------------------------------

### CompetencyFieldDescriptor Structure Example

Source: https://apidocs.tally.xyz/index

Illustrates the CompetencyFieldDescriptor structure, containing an ID, name, and description.

```json
{
  "id": 2207450143689540900,
  "name": "xyz789",
  "description": "xyz789"
}
```

--------------------------------

### Example GovernorMetadata JSON

Source: https://apidocs.tally.xyz/index

This JSON object demonstrates the structure of GovernorMetadata, containing a description field.

```json
{"description": "abc123"}
```

--------------------------------

### Uint256 Example

Source: https://apidocs.tally.xyz/index

Example of a Uint256 scalar type, representing a large unsigned integer as a string.

```json
10987654321
```

--------------------------------

### HasVotedInput Example

Source: https://apidocs.tally.xyz/index

An example of the HasVotedInput structure, used to check voting status for a specific address.

```json
{
  "address": "0x1234567800000000000000000000000000000abc"
}
```

--------------------------------

### VotesSortBy Enum Value Example

Source: https://apidocs.tally.xyz/index

Example of a VotesSortBy enum value, demonstrating sorting by 'id'.

```json
"id"
```

--------------------------------

### VoteStats Data Structure Example

Source: https://apidocs.tally.xyz/index

Shows an example of the VoteStats structure, used for voting summary per choice, including type, votesCount, votersCount, and percent.

```json
{
  "type": "abstain",
  "votesCount": 10987654321,
  "votersCount": 987,
  "percent": 987.65
}
```

--------------------------------

### ID Example

Source: https://apidocs.tally.xyz/index

An example of the ID scalar type, representing a unique identifier for objects or cache keys.

```json
"4"
```

--------------------------------

### GovernorsSortBy Example

Source: https://apidocs.tally.xyz/index

An example value for GovernorsSortBy, indicating the sorting criteria. 'id' is the default, sorting by date.

```json
"id"
```

--------------------------------

### VetoVote Data Structure Example

Source: https://apidocs.tally.xyz/index

Provides an example of the VetoVote structure, detailing fields like id, amount, createdAt, proposal, type, and voter.

```json
{
  "id": 2207450143689540900,
  "amount": 10987654321,
  "createdAt": 1663224162,
  "proposal": Proposal,
  "type": "abstain",
  "voter": Account
}
```

--------------------------------

### Tally API - Delegate Variables

Source: https://apidocs.tally.xyz/index

This example shows the variables required for the `Delegate` GraphQL query, specifically the `input` argument which is of type `DelegateInput`.

```GraphQL
{"input": DelegateInput}
```

--------------------------------

### VotesSortInput Data Structure Example

Source: https://apidocs.tally.xyz/index

Illustrates the VotesSortInput structure, specifying sorting direction and criteria.

```json
{"isDescending": false, "sortBy": "id"}
```

--------------------------------

### AccountID Example

Source: https://apidocs.tally.xyz/index

Demonstrates the format of an AccountID, which is a CAIP-10 compliant identifier.

```String
"eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc"
```

--------------------------------

### Token Example

Source: https://apidocs.tally.xyz/index

Represents an on-chain token, including its ID, type, name, symbol, supply, decimals, and eligibility.

```json
{
  "id": "eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f",
  "type": "ERC20",
  "name": "abc123",
  "symbol": "abc123",
  "supply": 10987654321,
  "decimals": 123,
  "eligibility": Eligibility,
  "isIndexing": true,
  "isBehind": true
}
```

--------------------------------

### Example Float Scalar Value

Source: https://apidocs.tally.xyz/index

This example demonstrates a typical value for the Float scalar type, representing a signed double-precision fractional number.

```number
123.45
```

--------------------------------

### Example ExecutableCall JSON

Source: https://apidocs.tally.xyz/index

This JSON object illustrates a complete ExecutableCall, showcasing all its fields such as calldata, chain ID, index, signature, target, type, value, and decoded calldata.

```json
{
  "calldata": "0x4321abcd",
  "chainId": "eip155:1",
  "index": 987,
  "signature": "xyz789",
  "target": "0x1234567800000000000000000000000000000abc",
  "type": "custom",
  "value": 10987654321,
  "decodedCalldata": DecodedCalldata
}
```

--------------------------------

### Example ExecutableCallType Enum Value

Source: https://apidocs.tally.xyz/index

This example shows a single enum value for ExecutableCallType, which can be one of several predefined types like 'custom', 'erc20transfer', etc.

```string
"custom"
```

--------------------------------

### HasVoted Example

Source: https://apidocs.tally.xyz/index

An example of the HasVoted structure, indicating a user's voting status and the type of vote.

```json
{"value": true, "voteType": "onchain"}
```

--------------------------------

### Example GovernorContract JSON

Source: https://apidocs.tally.xyz/index

This JSON object shows a GovernorContract, including its address and type.

```json
{
  "address": "0x1234567800000000000000000000000000000abc",
  "type": "governoralpha"
}
```

--------------------------------

### TokenInput Example

Source: https://apidocs.tally.xyz/index

Input structure for specifying a token by its ID.

```json
{
  "id": "eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f"
}
```

--------------------------------

### Example GovernorParameters JSON

Source: https://apidocs.tally.xyz/index

This JSON object illustrates the parameters for a Governor, including quorum votes, proposal threshold, voting delay, voting period, grace period, quorum numerator and denominator, clock mode, counting mode, nominee vetting duration, and full weight duration.

```json
{
  "quorumVotes": 10987654321,
  "proposalThreshold": 10987654321,
  "votingDelay": 10987654321,
  "votingPeriod": 10987654321,
  "gracePeriod": 10987654321,
  "quorumNumerator": 10987654321,
  "quorumDenominator": 10987654321,
  "clockMode": "abc123",
  "countingMode": "xyz789",
  "nomineeVettingDuration": 10987654321,
  "fullWeightDuration": 10987654321
}
```

--------------------------------

### Example GovernorType Enum Value

Source: https://apidocs.tally.xyz/index

This example shows a single enum value for GovernorType, which can be 'governoralpha', 'governorbravo', 'openzeppelingovernor', etc.

```string
"governoralpha"
```

--------------------------------

### GovernorsFiltersInput Example

Source: https://apidocs.tally.xyz/index

An example of the GovernorsFiltersInput structure, used for filtering governance-related data. It includes organization ID and flags for inactive or secondary entities.

```json
{
  "organizationId": 2207450143689540900,
  "includeInactive": false,
  "excludeSecondary": false
}
```

--------------------------------

### Tally API - Delegate Response Example

Source: https://apidocs.tally.xyz/index

This JSON response illustrates the data returned for a delegate, including their ID, account details, chain ID, delegators count, governor information, organization, statement, token, vote count, and prioritization status.

```JSON
{
  "data": {
    "delegate": {
      "id": 2207450143689540900,
      "account": Account,
      "chainId": "eip155:1",
      "delegatorsCount": 987,
      "governor": Governor,
      "organization": Organization,
      "statement": DelegateStatement,
      "token": Token,
      "votesCount": 10987654321,
      "isPrioritized": false
    }
  }
}
```

--------------------------------

### StakePosition Example

Source: https://apidocs.tally.xyz/index

Details of a user's stake position, including deposit ID, balance, transaction hash, delegate account, and earning power.

```json
{
  "depositId": 10987654321,
  "balance": 10987654321,
  "txHash": "0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855",
  "delegateAccount": Account,
  "earningPower": EarningPower
}
```

--------------------------------

### VotesInput Data Structure Example

Source: https://apidocs.tally.xyz/index

Shows the structure for VotesInput, which includes filters, page, and sort parameters.

```json
{
  "filters": VotesFiltersInput,
  "page": PageInput,
  "sort": VotesSortInput
}
```

--------------------------------

### Example GovernorKind Enum Value

Source: https://apidocs.tally.xyz/index

This example shows a single enum value for GovernorKind, which can be 'single', 'multiprimary', 'multisecondary', etc.

```string
"single"
```

--------------------------------

### TokenContract Example

Source: https://apidocs.tally.xyz/index

Represents a token contract, specifying its address and type.

```json
{
  "address": "0x1234567800000000000000000000000000000abc",
  "type": "ERC20"
}
```

--------------------------------

### Example ExecutableCall JSON

Source: https://apidocs.tally.xyz/index

This JSON object demonstrates the structure of an ExecutableCall, including its calldata, chain ID, index, signature, target, type, value, and decoded calldata.

```json
{
  "id": 2207450143689540900,
  "competencyFields": [CompetencyFieldDescriptor]
}
```

--------------------------------

### VetoVoteParameters Data Structure Example

Source: https://apidocs.tally.xyz/index

Illustrates the VetoVoteParameters structure, showing votingPeriod, extendedVotingPeriod, and quorum.

```json
{"votingPeriod": 987, "extendedVotingPeriod": 123, "quorum": 10987654321}
```

--------------------------------

### StakeDeposit Example

Source: https://apidocs.tally.xyz/index

Represents a stake deposit transaction, including the deposit ID.

```json
{"depositId": 10987654321}
```

--------------------------------

### Bytes Type Example

Source: https://apidocs.tally.xyz/index

Illustrates the Bytes type, which represents arbitrary length binary data as a 0x-prefixed hexadecimal string.

```string
"0x4321abcd"
```

--------------------------------

### StakeEvent Example

Source: https://apidocs.tally.xyz/index

Represents a stake event, including stake amount, block information, transaction hash, and type.

```json
{
  "stakeAmount": 10987654321,
  "block": Block,
  "type": "deposit",
  "txHash": "0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855",
  "shareAmount": 10987654321
}
```

--------------------------------

### ValueDecoded Data Structure Example

Source: https://apidocs.tally.xyz/index

Demonstrates the structure of the ValueDecoded type, including operation, to, value, data, and dataDecoded fields.

```json
{
  "operation": 987,
  "to": "xyz789",
  "value": "xyz789",
  "data": "abc123",
  "dataDecoded": DataDecoded
}
```

--------------------------------

### Example GovernorInput JSON

Source: https://apidocs.tally.xyz/index

This JSON object represents input parameters for a Governor query, including its ID and slug.

```json
{
  "id": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "slug": "xyz789"
}
```

--------------------------------

### BlocklessTimestamp Structure Example

Source: https://apidocs.tally.xyz/index

Shows the structure for BlocklessTimestamp, which contains a single timestamp field.

```json
{"timestamp": 1663224162}
```

--------------------------------

### GraphQL Query Variables for Accounts

Source: https://apidocs.tally.xyz/index

Example variables to use with the GraphQL 'Accounts' query, specifying account IDs and addresses for filtering.

```json
{
  "ids": [
    "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc"
  ],
  "addresses": [
    "0x1234567800000000000000000000000000000abc"
  ]
}
```

--------------------------------

### EligibilityStatus Enum Example

Source: https://apidocs.tally.xyz/index

Defines the possible statuses for eligibility, indicating whether an account is 'NOTELIGIBLE', 'ELIGIBLE', or has already 'CLAIMED' their rewards. This simplifies status checks.

```json
"NOTELIGIBLE"
```

--------------------------------

### Boolean Type Example

Source: https://apidocs.tally.xyz/index

Demonstrates the Boolean scalar type, representing either true or false.

```boolean
true
```

--------------------------------

### VotesFiltersInput Data Structure Example

Source: https://apidocs.tally.xyz/index

Demonstrates the VotesFiltersInput structure with various filtering options like proposalId, voter, and vote type.

```json
{
  "proposalId": 2207450143689540900,
  "proposalIds": [2207450143689540900],
  "voter": "0x1234567800000000000000000000000000000abc",
  "includePendingVotes": true,
  "type": "abstain",
  "isVetoVote": true,
  "chainId": "eip155:1",
  "hasReason": true
}
```

--------------------------------

### Example Governor JSON

Source: https://apidocs.tally.xyz/index

This JSON object represents a Governor, detailing its ID, chain ID, contracts, indexing status, primary status, kind, name, organization, proposal statistics, parameters, quorum, slug, timelock ID, token ID, token, type, delegate counts, and metadata.

```json
{
  "id": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "chainId": "eip155:1",
  "contracts": Contracts,
  "isIndexing": false,
  "isBehind": false,
  "isPrimary": true,
  "kind": "single",
  "name": "Uniswap",
  "organization": Organization,
  "proposalStats": ProposalStats,
  "parameters": GovernorParameters,
  "quorum": 10987654321,
  "slug": "uniswap",
  "timelockId": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "tokenId": "eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f",
  "token": Token,
  "type": "governoralpha",
  "delegatesCount": 987,
  "delegatesVotesCount": 10987654321,
  "tokenOwnersCount": 987,
  "metadata": GovernorMetadata
}
```

--------------------------------

### Organizations Sort By Enum Example

Source: https://apidocs.tally.xyz/index

Illustrates the possible values for sorting organizations, including sorting by ID, name, popularity, or explore-based metrics.

```json
"id"
```

--------------------------------

### VoteType Enum Value Example

Source: https://apidocs.tally.xyz/index

Example of a VoteType enum value, specifically 'abstain'.

```json
"abstain"
```

--------------------------------

### EarningPowerTrackerEventType Enum Example

Source: https://apidocs.tally.xyz/index

An enumeration of possible event types that affect earning power, such as deposits, withdrawals, or changes related to claimers or delegates. This helps categorize earning power modifications.

```json
"deposited"
```

--------------------------------

### DelegationsSortBy Enum Example

Source: https://apidocs.tally.xyz/index

Specifies the criteria for sorting delegations, either by their ID (default, chronological) or by voting power. This allows users to order delegation results as needed.

```json
"id"
```

--------------------------------

### Proposal Metadata Structure

Source: https://apidocs.tally.xyz/index

Contains metadata for a proposal, including its title, description, execution ETA, IPFS hash, and URLs for discourse and snapshot.

```json
{
  "title": "Fund the Grants Program",
  "description": "Here's why it's a good idea to fund the Grants Program",
  "eta": 1675437793,
  "ipfsHash": "xyz789",
  "previousEnd": 123,
  "timelockId": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "txHash": "0xcd31cf5dbd3281442d80ceaa529eba678d55be86b7a342f5ed9cc8e49dadc855",
  "discourseURL": "xyz789",
  "snapshotURL": "abc123"
}
```

--------------------------------

### Query Proposals

Source: https://apidocs.tally.xyz/index

Fetches a list of proposals with detailed information about each type (Delegate, Organization, Member, etc.). Includes pagination information.

```GraphQL
query Proposals($input: ProposalsInput!) {
  proposals(input: $input) {
    nodes {
      ... on Delegate {
        ...DelegateFragment
      }
      ... on Organization {
        ...OrganizationFragment
      }
      ... on Member {
        ...MemberFragment
      }
      ... on Delegation {
        ...DelegationFragment
      }
      ... on Governor {
        ...GovernorFragment
      }
      ... on Proposal {
        ...ProposalFragment
      }
      ... on OnchainVote {
        ...OnchainVoteFragment
      }
      ... on VetoVote {
        ...VetoVoteFragment
      }
      ... on StakeEvent {
        ...StakeEventFragment
      }
      ... on StakeEarning {
        ...StakeEarningFragment
      }
      ... on Contributor {
        ...ContributorFragment
      }
      ... on Assignment {
        ...AssignmentFragment
      }
      ... on StakePosition {
        ...StakePositionFragment
      }
      ... on StakeDeposit {
        ...StakeDepositFragment
      }
      ... on DelegationEvent {
        ...DelegationEventFragment
      }
      ... on DelegationVoteEvent {
        ...DelegationVoteEventFragment
      }
    }
    pageInfo {
      firstCursor
      lastCursor
      count
    }
  }
}
```

--------------------------------

### Query Delegates - Tally API

Source: https://apidocs.tally.xyz/index

Fetches a paginated list of delegates matching specified filters. The output contains a list of delegate nodes and page information. Requires a DelegatesInput object.

```GraphQL
query Delegates($input: DelegatesInput!) {
  delegates(input: $input) {
    nodes {
      ... on Delegate {
        ...DelegateFragment
      }
      ... on Organization {
        ...OrganizationFragment
      }
      ... on Member {
        ...MemberFragment
      }
      ... on Delegation {
        ...DelegationFragment
      }
      ... on Governor {
        ...GovernorFragment
      }
      ... on Proposal {
        ...ProposalFragment
      }
      ... on OnchainVote {
        ...OnchainVoteFragment
      }
      ... on VetoVote {
        ...VetoVoteFragment
      }
      ... on StakeEvent {
        ...StakeEventFragment
      }
      ... on StakeEarning {
        ...StakeEarningFragment
      }
      ... on Contributor {
        ...ContributorFragment
      }
      ... on Assignment {
        ...AssignmentFragment
      }
      ... on StakePosition {
        ...StakePositionFragment
      }
      ... on StakeDeposit {
        ...StakeDepositFragment
      }
      ... on DelegationEvent {
        ...DelegationEventFragment
      }
      ... on DelegationVoteEvent {
        ...DelegationVoteEventFragment
      }
    }
    pageInfo {
      firstCursor
      lastCursor
      count
    }
  }
}

{"input": DelegatesInput}
```

--------------------------------

### ProposalsInput Structure

Source: https://apidocs.tally.xyz/index

Defines the input structure for querying proposals, including filters, pagination, and sorting parameters.

```json
{
  "filters": ProposalsFiltersInput,
  "page": PageInput,
  "sort": ProposalsSortInput
}
```

--------------------------------

### Page Input Structure

Source: https://apidocs.tally.xyz/index

Defines parameters for cursor-based pagination, allowing users to specify a cursor for fetching subsequent or previous pages and a limit for items per page.

```json
{
  "afterCursor": "abc123",
  "beforeCursor": "abc123",
  "limit": 987
}
```

--------------------------------

### Tally API Base URL

Source: https://apidocs.tally.xyz/index

The base URL for making requests to the Tally API.

```text
https://api.tally.xyz/query
```

--------------------------------

### DelegatesInput Structure

Source: https://apidocs.tally.xyz/index

Input structure for querying delegates, including filters, pagination, and sorting options.

```json
{
  "filters": DelegatesFiltersInput,
  "page": PageInput,
  "sort": DelegatesSortInput
}
```

--------------------------------

### Query Governors - Tally API

Source: https://apidocs.tally.xyz/index

Fetches a list of governors with detailed fragments for various governance-related types. Includes pagination information.

```GraphQL
query Governors($input: GovernorsInput!) {
  governors(input: $input) {
    nodes {
      ... on Delegate {
        ...DelegateFragment
      }
      ... on Organization {
        ...OrganizationFragment
      }
      ... on Member {
        ...MemberFragment
      }
      ... on Delegation {
        ...DelegationFragment
      }
      ... on Governor {
        ...GovernorFragment
      }
      ... on Proposal {
        ...ProposalFragment
      }
      ... on OnchainVote {
        ...OnchainVoteFragment
      }
      ... on VetoVote {
        ...VetoVoteFragment
      }
      ... on StakeEvent {
        ...StakeEventFragment
      }
      ... on StakeEarning {
        ...StakeEarningFragment
      }
      ... on Contributor {
        ...ContributorFragment
      }
      ... on Assignment {
        ...AssignmentFragment
      }
      ... on StakePosition {
        ...StakePositionFragment
      }
      ... on StakeDeposit {
        ...StakeDepositFragment
      }
      ... on DelegationEvent {
        ...DelegationEventFragment
      }
      ... on DelegationVoteEvent {
        ...DelegationVoteEventFragment
      }
    }
    pageInfo {
      firstCursor
      lastCursor
      count
    }
  }
}


```

--------------------------------

### DelegationsInput Data Structure

Source: https://apidocs.tally.xyz/index

Defines the input for fetching delegations, incorporating filters, pagination (page), and sorting preferences. This structure enables comprehensive querying of delegation data.

```json
{
  "filters": DelegationsFiltersInput,
  "page": PageInput,
  "sort": DelegationsSortInput
}
```

--------------------------------

### Query Delegatees - Tally API

Source: https://apidocs.tally.xyz/index

Retrieves a paginated list of delegatees based on provided filters. The response includes a list of delegatee nodes and pagination information. Requires a DelegationsInput object.

```GraphQL
query Delegatees($input: DelegationsInput!) {
  delegatees(input: $input) {
    nodes {
      ... on Delegate {
        ...DelegateFragment
      }
      ... on Organization {
        ...OrganizationFragment
      }
      ... on Member {
        ...MemberFragment
      }
      ... on Delegation {
        ...DelegationFragment
      }
      ... on Governor {
        ...GovernorFragment
      }
      ... on Proposal {
        ...ProposalFragment
      }
      ... on OnchainVote {
        ...OnchainVoteFragment
      }
      ... on VetoVote {
        ...VetoVoteFragment
      }
      ... on StakeEvent {
        ...StakeEventFragment
      }
      ... on StakeEarning {
        ...StakeEarningFragment
      }
      ... on Contributor {
        ...ContributorFragment
      }
      ... on Assignment {
        ...AssignmentFragment
      }
      ... on StakePosition {
        ...StakePositionFragment
      }
      ... on StakeDeposit {
        ...StakeDepositFragment
      }
      ... on DelegationEvent {
        ...DelegationEventFragment
      }
      ... on DelegationVoteEvent {
        ...DelegationVoteEventFragment
      }
    }
    pageInfo {
      firstCursor
      lastCursor
      count
    }
  }
}

{"input": DelegationsInput}
```

--------------------------------

### Page Info Structure

Source: https://apidocs.tally.xyz/index

Provides metadata for paginated results, including cursors for navigating between pages and the total count of items.

```json
{
  "firstCursor": "xyz789",
  "lastCursor": "xyz789",
  "count": 123
}
```

--------------------------------

### Proposal Status Enumeration

Source: https://apidocs.tally.xyz/index

Lists all possible statuses a proposal can have throughout its lifecycle, such as 'active', 'executed', 'defeated', etc.

```json
"active"
```

--------------------------------

### DelegateInput Structure

Source: https://apidocs.tally.xyz/index

Input structure for creating or updating a delegate, specifying address and related IDs.

```json
{
  "address": "0x1234567800000000000000000000000000000abc",
  "governorId": "eip155:1:0x7e90e03654732abedf89Faf87f05BcD03ACEeFdc",
  "organizationId": 2207450143689540900
}
```

--------------------------------

### Tally API - Query Delegate

Source: https://apidocs.tally.xyz/index

This GraphQL query fetches detailed information about a delegate, including their account details, associated governor, organization, statement, token information, and voting statistics. It requires a DelegateInput argument.

```GraphQL
query Delegate($input: DelegateInput!) {
  delegate(input: $input) {
    id
    account {
      id
      address
      ens
      twitter
      name
      bio
      picture
      safes
      type
      votes
      proposalsCreatedCount
    }
    chainId
    delegatorsCount
    governor {
      id
      chainId
      contracts {
        ...ContractsFragment
      }
      isIndexing
      isBehind
      isPrimary
      kind
      name
      organization {
        ...OrganizationFragment
      }
      proposalStats {
        ...ProposalStatsFragment
      }
      parameters {
        ...GovernorParametersFragment
      }
      quorum
      slug
      timelockId
      tokenId
      token {
        ...TokenFragment
      }
      type
      delegatesCount
      delegatesVotesCount
      tokenOwnersCount
      metadata {
        ...GovernorMetadataFragment
      }
    }
    organization {
      id
      slug
      name
      chainIds
      tokenIds
      governorIds
      metadata {
        ...OrganizationMetadataFragment
      }
      creator {
        ...AccountFragment
      }
      hasActiveProposals
      proposalsCount
      delegatesCount
      delegatesVotesCount
      tokenOwnersCount
      endorsementService {
        ...EndorsementServiceFragment
      }
      contracts {
        ...ContractFragment
      }
    }
    statement {
      id
      address
      organizationID
      statement
      statementSummary
      isSeekingDelegation
      issues {
        ...IssueFragment
      }
    }
    token {
      id
      type
      name
      symbol
      supply
      decimals
      eligibility {
        ...EligibilityFragment
      }
      isIndexing
      isBehind
    }
    votesCount
    isPrioritized
  }
}
```

--------------------------------

### Paginated List of Proposals

Source: https://apidocs.tally.xyz/index

Retrieves a paginated list of proposals, allowing for filtering based on provided criteria. The response includes pagination information and a list of proposals matching the filters.

```graphql
query Proposals($input: ProposalsInput!) {
  proposals(input: $input) {
    id
    onchainId
    block {
      id
      number
      timestamp
      ts
    }
    chainId
    creator {
      id
      address
      ens
      twitter
      name
      bio
      picture
      safes
      type
      votes
      proposalsCreatedCount
    }
    end {
      ... on Block {
        ...BlockFragment
      }
      ... on BlocklessTimestamp {
        ...BlocklessTimestampFragment
      }
    }
    events {
      block {
        ...BlockFragment
      }
      chainId
      createdAt
      type
      txHash
    }
    executableCalls {
      calldata
      chainId
      index
      signature
      target
      type
      value
      decodedCalldata {
        ...DecodedCalldataFragment
      }
    }
    governor {
      id
      chainId
      contracts {
        ...ContractsFragment
      }
      isIndexing
      isBehind
      isPrimary
      kind
      name
      organization {
        ...OrganizationFragment
      }
      proposalStats {
        ...ProposalStatsFragment
      }
      parameters {
        ...GovernorParametersFragment
      }
      quorum
      slug
      timelockId
      tokenId
      token {
        ...TokenFragment
      }
      type
      delegatesCount
      delegatesVotesCount
      tokenOwnersCount
      metadata {
        ...GovernorMetadataFragment
      }
    }
    metadata {
      title
      description
      eta
      ipfsHash
      previousEnd
      timelockId
      txHash
      discourseURL
      snapshotURL
    }
    organization {
      id
      slug
      name
      chainIds
      tokenIds
      governorIds
      metadata {
        ...OrganizationMetadataFragment
      }
      creator {
        ...AccountFragment
      }
      hasActiveProposals
      proposalsCount
      delegatesCount
      delegatesVotesCount
      tokenOwnersCount
      endorsementService {
        ...EndorsementServiceFragment
      }
      contracts {
        ...ContractFragment
      }
    }
    proposer {
      id
      address
      ens
      twitter
      name
      bio
      picture
      safes
      type
      votes
      proposalsCreatedCount
    }
    quorum
    status
    start {
      ... on Block {
        ...BlockFragment
      }
      ... on BlocklessTimestamp {
        ...BlocklessTimestampFragment
      }
    }
    voteStats {
      type
      votesCount
      votersCount
      percent
    }
    signalVoteServiceId
    vetoVoteParameters {
      votingPeriod
      extendedVotingPeriod
      quorum
    }
    vetoVoteStats {
      type
      votesCount
      votersCount
      percent
    }
    hasVoted {
      value
      voteType
    }
  }
}
```

--------------------------------

### Tally API - Query Chains

Source: https://apidocs.tally.xyz/index

This GraphQL query retrieves a list of chains supported by Tally. It fetches details such as chain ID, layer 1 ID, name, block time, testnet status, native currency information, and voting period usage.

```GraphQL
query Chains {
  chains {
    id
    layer1Id
    name
    mediumName
    shortName
    blockTime
    isTestnet
    nativeCurrency {
      name
      symbol
      decimals
    }
    chain
    useLayer1VotingPeriod
  }
}
```