---
updatedAt: 2026-07-26T13:21:38.000Z
---
Fetch the complete documentation index at: https://docs.noves.fi/llms.txt. Use this file to discover all available pages before exploring further.
# /{chain}/featuredApps/{providerParty}/activity/verdicts/submitters
Returns submitter attribution and bucketed verdict counts, aggregated by hour buckets. The requested startTimestamp is rounded down and endTimestamp is rounded up to their UTC hour boundaries.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Canton API",
"description": "Access public Canton updates, balances, prices, rewards, and more. Set up your own streams and alerts. Fetch fully reconciliable, accounting-grade data. Powered by Noves.",
"version": "v1"
},
"servers": [
{
"url": "https://api.canton.noves.fi/"
}
],
"paths": {
"/{chain}/featuredApps/{providerParty}/activity/verdicts/submitters": {
"get": {
"tags": [
"FeaturedApps"
],
"summary": "/{chain}/featuredApps/{providerParty}/activity/verdicts/submitters",
"description": "Returns submitter attribution and bucketed verdict counts, aggregated by hour buckets. The requested startTimestamp is rounded down and endTimestamp is rounded up to their UTC hour boundaries.",
"parameters": [
{
"name": "chain",
"in": "path",
"description": "Chain name. Use a chain returned by `GET /chains`.",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"default": "canton",
"example": "canton"
}
},
{
"name": "providerParty",
"in": "path",
"description": "Featured App provider party.",
"required": true,
"style": "simple",
"schema": {
"type": "string"
}
},
{
"name": "startTimestamp",
"in": "query",
"description": "Start timestamp to filter results by (Unix timestamp). Optional.",
"style": "form",
"schema": {
"maximum": 253402300799,
"minimum": -62135596800,
"type": "integer",
"format": "int64"
}
},
{
"name": "endTimestamp",
"in": "query",
"description": "End timestamp to filter results by (Unix timestamp). Optional.",
"style": "form",
"schema": {
"maximum": 253402300799,
"minimum": -62135596800,
"type": "integer",
"format": "int64"
}
},
{
"name": "bucketHours",
"in": "query",
"description": "Bucket width in hours from 1 through 720. The response cannot exceed 2,000 buckets.",
"style": "form",
"schema": {
"maximum": 720,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 24
}
},
{
"name": "apiKey",
"in": "header",
"description": "API Key for Canton API. To generate an API Key, visit https://app.noves.fi",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"default": "demokey"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FeaturedAppVerdictSubmittersResponseDto"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"409": {
"description": "Conflict",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"502": {
"description": "Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"FeaturedAppTopSubmitterDto": {
"required": [
"party",
"validatorOwned",
"verdictCount"
],
"type": "object",
"properties": {
"party": {
"minLength": 1,
"type": "string",
"description": "Submitting party."
},
"verdictCount": {
"type": "integer",
"description": "Verdicts attributed to the submitting party.",
"format": "int64"
},
"validatorOwned": {
"type": "boolean",
"description": "True when the submitting party belongs to the Featured App's validator set."
}
},
"additionalProperties": false,
"description": "Verdict activity attributed to one submitting party."
},
"FeaturedAppVerdictSubmitterBucketDto": {
"required": [
"confirmerConfirmed",
"startTime",
"thirdPartySubmitted",
"total",
"uniqueSubmitters",
"validatorSubmitted"
],
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "Total verdict count.",
"format": "int64"
},
"confirmerConfirmed": {
"type": "integer",
"description": "Verdicts confirmed by configured confirmer parties.",
"format": "int64"
},
"validatorSubmitted": {
"type": "integer",
"description": "Verdicts submitted by configured validator parties.",
"format": "int64"
},
"thirdPartySubmitted": {
"type": "integer",
"description": "Verdicts submitted by parties outside the configured validator set.",
"format": "int64"
},
"uniqueSubmitters": {
"type": "integer",
"description": "Number of distinct submitting parties.",
"format": "int64"
},
"startTime": {
"type": "string",
"description": "Inclusive bucket start (ISO 8601).",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "Verdict and unique-submitter totals for one time bucket."
},
"FeaturedAppVerdictSubmitterPeriodDto": {
"required": [
"bucketHours",
"endTime",
"requestedEndTime",
"requestedStartTime",
"startTime",
"timestampsRounded"
],
"type": "object",
"properties": {
"startTime": {
"type": "string",
"description": "Inclusive UTC-hour-aligned start used for the query (ISO 8601).",
"format": "date-time"
},
"endTime": {
"type": "string",
"description": "Exclusive UTC-hour-aligned end used for the query (ISO 8601).",
"format": "date-time"
},
"requestedStartTime": {
"type": "string",
"description": "Requested start before UTC-hour rounding (ISO 8601).",
"format": "date-time"
},
"requestedEndTime": {
"type": "string",
"description": "Requested end before UTC-hour rounding (ISO 8601).",
"format": "date-time"
},
"timestampsRounded": {
"type": "boolean",
"description": "True when the gateway rounded either requested timestamp."
},
"bucketHours": {
"type": "integer",
"description": "Width of each response bucket in hours.",
"format": "int32"
}
},
"additionalProperties": false,
"description": "Requested and UTC-hour-aligned verdict-submitter query period."
},
"FeaturedAppVerdictSubmitterSummaryDto": {
"required": [
"confirmerConfirmed",
"thirdPartySubmitted",
"total",
"uniqueSubmitters",
"validatorSubmitted"
],
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "Total verdict count.",
"format": "int64"
},
"confirmerConfirmed": {
"type": "integer",
"description": "Verdicts confirmed by configured confirmer parties.",
"format": "int64"
},
"validatorSubmitted": {
"type": "integer",
"description": "Verdicts submitted by configured validator parties.",
"format": "int64"
},
"thirdPartySubmitted": {
"type": "integer",
"description": "Verdicts submitted by parties outside the configured validator set.",
"format": "int64"
},
"uniqueSubmitters": {
"type": "integer",
"description": "Number of distinct submitting parties.",
"format": "int64"
}
},
"additionalProperties": false,
"description": "Verdict and unique-submitter totals."
},
"FeaturedAppVerdictSubmittersResponseDto": {
"required": [
"buckets",
"period",
"summary",
"topSubmitters"
],
"type": "object",
"properties": {
"period": {
"allOf": [
{
"$ref": "#/components/schemas/FeaturedAppVerdictSubmitterPeriodDto"
}
],
"description": "Requested and UTC-hour-aligned query bounds."
},
"summary": {
"allOf": [
{
"$ref": "#/components/schemas/FeaturedAppVerdictSubmitterSummaryDto"
}
],
"description": "Verdict and unique-submitter totals for the effective period."
},
"buckets": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FeaturedAppVerdictSubmitterBucketDto"
},
"description": "Verdict totals grouped by bucket start."
},
"topSubmitters": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FeaturedAppTopSubmitterDto"
},
"description": "Highest-volume submitting parties for the effective period."
}
},
"additionalProperties": false,
"description": "Featured App verdict activity grouped by submitter."
},
"ProblemDetails": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": {}
}
}
}
}
```