GET /api/v1/indexer/suckerGroup

Parameters

Name	Location	Details
`X-Juicebox-Account`	header / required	Enrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
`X-Juicebox-Signer`	header / required	Owner wallet or authorized bot address that signed this request.
`X-Juicebox-Issued-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
`X-Juicebox-Expires-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
`X-Juicebox-Nonce`	header / required	Fresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
`X-Juicebox-Signature`	header / required	EIP-712 CenterRequest signature over every signed field. Contract-owner signatures may vary in length. This is a computed request proof, not a reusable API key.
`X-Juicebox-Grant`	header / optional	Authorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
`Idempotency-Key`	header / optional	Signed retry identity. Required on plan creation and transaction submission. Preserve exact method, target, Content-Type, and body bytes; use a fresh request nonce and signature.
`network`	query / required	string `["mainnet","testnet"]`
`chainId`	query / optional	Must belong to the chosen indexer network. `[1,10,8453,42161,84532,421614,11155111,11155420]`
`projectId`	query / optional	List filters use the indexer's signed 32-bit GraphQL Int range.
`fields`	query / optional	Bounded scalar field paths or supported singular relations. Identity fields are always included. Serialize as JSON once, percent-encode the query value, then sign the exact resulting request target.
`filters`	query / optional	Serialize as JSON once, percent-encode the query value, then sign the exact resulting request target.
`orderBy`	query / optional	Serialize as JSON once, percent-encode the query value, then sign the exact resulting request target.
`limit`	query / optional	integer
`cursor`	query / optional	string

Response 200

Field Type Details

entity

string
required

Values: ["suckerGroup"]

network

string
required

Values: ["mainnet","testnet"]

protocolVersion

integer
required

Values: [6]

items

array
required

Fields

Field	Type	Details
`addresses`	array optional
`balance`	string optional
`balanceUsd`	string optional
`contributorsCount`	integer optional
`createdAt`	integer optional
`id`	string required
`nftsMintedCount`	integer optional
`paymentsCount`	integer optional
`redeemCount`	integer optional
`redeemVolume`	string optional
`redeemVolumeUsd`	string optional
`reservedTokenSupply`	string optional
`tokenSupply`	string optional
`trendingPaymentsCount`	integer optional
`trendingScore`	string optional
`trendingVolume`	string optional
`version`	integer required	Values: `[6]`
`volume`	string optional
`volumeUsd`	string optional

totalCount integer
required

pageInfo

object
required

Fields

Field	Type	Details
`hasNextPage`	boolean required
`hasPreviousPage`	boolean required
`startCursor`	one of required
`endCursor`	one of required

nextCursor one of
required

provenance object
required

semantics object
required Bendystraw indexing is not a canonical block-hash snapshot. Preserve lag, pagination, scope, and unknown-field semantics.

JSON schema

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "const": "suckerGroup"
    },
    "network": {
      "type": "string",
      "enum": [
        "mainnet",
        "testnet"
      ]
    },
    "protocolVersion": {
      "$ref": "#/components/schemas/ProtocolVersion"
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/IndexerRow_suckerGroup"
      },
      "maxItems": 50
    },
    "totalCount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageInfo": {
      "$ref": "#/components/schemas/IndexerPageInfo"
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "provenance": {
      "type": "object",
      "additionalProperties": true
    },
    "semantics": {
      "$ref": "#/components/schemas/IndexerSemantics"
    }
  },
  "required": [
    "entity",
    "network",
    "protocolVersion",
    "items",
    "totalCount",
    "pageInfo",
    "nextCursor",
    "provenance",
    "semantics"
  ],
  "additionalProperties": false
}