---
updatedAt: 2026-09-10T06:54:46.000Z
---

Fetch the complete documentation index at: https://docs.ccview.io/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Asset issuer available rewards by venue

Returns the asset issuer's available rewards for the requested day, broken down by venue (the party of the validator that submitted the accepted verdicts). Each entry indicates whether the venue is a DvP application and whether it is the issuer's own linked venue.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "CantonView Public API",
    "description": "Public API for accessing Canton Network explorer data through CCView",
    "contact": {
      "name": "API Maintainer",
      "email": "cantonview@pixelplex.io"
    },
    "license": {
      "name": ""
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://ccview.io",
      "description": "Production HTTPS server"
    }
  ],
  "paths": {
    "/api/rewards/asset-issuer/{party_id}": {
      "get": {
        "tags": [
          "Rewards"
        ],
        "summary": "Get asset issuer rewards at a venue for a day",
        "description": "Returns an asset issuer's activity and estimated rewards at one venue for a single UTC day.\n\n`party_id` is the asset's instrument admin party (registrar). A featured app party is also accepted when it is mapped to its registrar. `venue_party_id` accepts either the submitting validator or a featured app party; an app party is resolved to its host validator using the current FeaturedAppRight records on ledger.\n\nWeights follow the reward rules and venue statuses in effect on the requested day. DvP venues are weighted under their own rule, applied from the date the venue's DvP status took effect.",
        "operationId": "rewards_asset_issuer_available_rewards_v1",
        "parameters": [
          {
            "name": "party_id",
            "in": "path",
            "description": "Instrument admin party (registrar) of the asset. A featured app party mapped to its\nregistrar, or an alias extra_id, is also accepted.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/PartyId"
            },
            "example": "cbtc-beneficiary::1220409a9fcc5ff6422e29ab978c22c004dde33202546b4bcbde24b25b85353366c2"
          },
          {
            "name": "day",
            "in": "query",
            "description": "UTC calendar day to report on, `YYYY-MM-DD`. Covers 00:00 to 24:00 UTC.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "example": "2026-09-05"
          },
          {
            "name": "venue_party_id",
            "in": "query",
            "description": "Submitting validator party, or a featured app party. An app party is resolved to its\nhost validator via current FeaturedAppRight records. Omit to return rewards broken down\nacross all venues.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/PartyId"
            },
            "example": "acme-lending::1220a7daf7140e112f15a46f2daa52fe9c8651024ff8705bb23c494275dd02209596"
          }
        ],
        "responses": {
          "200": {
            "description": "Stats for the issuer at the venue on the given day.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssetIssuerVenueReward"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AssetIssuerVenueReward": {
        "type": "object",
        "description": "Stats for the issuer at the venue on the given day.",
        "required": [
          "submitting_validator",
          "is_dvp",
          "is_own",
          "available_rewards_weight",
          "estimated_available_rewards_cc",
          "total_txs",
          "avg_traffic_bytes"
        ],
        "properties": {
          "app_party_id": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/PartyId",
                "description": "Party ID of the venue. Echoes the request's `venue_party_id`, when provided."
              }
            ]
          },
          "available_rewards_weight": {
            "type": "string",
            "format": "decimal",
            "description": "Reward weight attributable to the issuer from activity at this venue on the day.\nThis is the quantity that enters the network reward formula.",
            "example": "0.66207000000000000000000"
          },
          "avg_traffic_bytes": {
            "type": "string",
            "format": "decimal",
            "description": "Average synchronizer traffic per transaction at this venue, in bytes.",
            "example": "11034.5000000000000000"
          },
          "estimated_available_rewards_cc": {
            "type": "string",
            "format": "decimal",
            "description": "The weight converted to CC using the reward ratio of the day's rounds. Estimated,\nsince rounds still in their reward window can change the ratio.",
            "example": "3.0885457007048421910752498911"
          },
          "is_dvp": {
            "type": "boolean",
            "description": "Whether the venue settles delivery-versus-payment.",
            "example": false
          },
          "is_own": {
            "type": "boolean",
            "description": "Whether the venue is operated by the issuer.",
            "example": false
          },
          "submitting_validator": {
            "$ref": "#/components/schemas/PartyId",
            "description": "Validator party whose submissions the stats are computed on."
          },
          "total_txs": {
            "type": "integer",
            "format": "integer",
            "description": "Transfers of the issuer's assets processed by the venue on the day.",
            "example": 2
          }
        }
      },
      "PartyId": {
        "type": "string",
        "title": "PartyId",
        "format": "hint::hash",
        "description": "Party ID in format `hint::hash`\n \n- `hint` - human-readable prefix (optional, for debugging)\n \n- `hash` - cryptographic identifier (the real identity)",
        "example": "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90",
        "examples": [
          "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90"
        ],
        "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*::1220[a-f0-9]{64}$"
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Rewards",
      "description": "Rewards history and statistics"
    }
  ],
  "externalDocs": {
    "url": "https://swagger.io/resources/open-api/",
    "description": "OpenAPI Documentation Reference"
  }
}
```