---
updatedAt: 2026-08-17T14:37:11.000Z
agentTools:
projectIndex: https://docs.noves.fi/llms.txt
---
# /{chain}/transfers/{party}
Returns a paginated list of Canton Coin transfers involving a party.
Filter by party role, transfer type, or time range. If both startTimestamp and endTimestamp are omitted, the API returns the trailing 30 days.
Follow nextPageUrl or pass nextCursor as cursor to retrieve the next page.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Canton API",
"description": "Query public and private Canton updates, balances, prices, rewards, verdicts, and Featured App activity. Create stream subscriptions and alerts for ongoing delivery.",
"version": "v1"
},
"servers": [
{
"url": "https://api.canton.noves.fi/"
}
],
"paths": {
"/{chain}/transfers/{party}": {
"get": {
"tags": [
"Transfers"
],
"summary": "/{chain}/transfers/{party}",
"description": "Returns a paginated list of Canton Coin transfers involving a party.\r\n \r\nFilter by party role, transfer type, or time range. If both startTimestamp and endTimestamp are omitted, the API returns the trailing 30 days.\r\n \r\nFollow nextPageUrl or pass nextCursor as cursor to retrieve the next page.",
"parameters": [
{
"name": "chain",
"in": "path",
"description": "Canton chain name. Use a name returned by `GET /chains`.",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"default": "canton",
"example": "canton"
}
},
{
"name": "party",
"in": "path",
"description": "Full Canton party ID whose transfers are requested.",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"default": "noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941",
"example": "noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941"
}
},
{
"name": "partyRole",
"in": "query",
"description": "Party role to include: `sender`, `receiver`, or `all`. Default is `all`.",
"style": "form",
"schema": {
"type": "string"
}
},
{
"name": "startTimestamp",
"in": "query",
"description": "Start of the requested time window, as Unix seconds. Optional.",
"style": "form",
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "endTimestamp",
"in": "query",
"description": "End of the requested time window, as Unix seconds. Optional.",
"style": "form",
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "transferType",
"in": "query",
"description": "Transfer type to include, such as `transfer` or `buyTraffic`. Optional.",
"style": "form",
"schema": {
"type": "string"
}
},
{
"name": "pageSize",
"in": "query",
"description": "Maximum number of transfers returned per page. Default is 100; maximum is 500.",
"style": "form",
"schema": {
"maximum": 500,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 100
}
},
{
"name": "sort",
"in": "query",
"description": "Sort order by effective time. Supported values are `asc` and `desc`. Default is `desc`.",
"style": "form",
"schema": {
"type": "string",
"default": "desc"
}
},
{
"name": "cursor",
"in": "query",
"description": "Opaque cursor from the previous response's nextCursor. Optional.",
"style": "form",
"schema": {
"type": "string"
}
},
{
"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/TransfersResponseDto"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"504": {
"description": "Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"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": {}
},
"TransferItemDto": {
"type": "object",
"properties": {
"effectiveAt": {
"type": "string",
"description": "Time the transfer took effect on the ledger (ISO 8601).",
"format": "date-time"
},
"updateId": {
"type": "string",
"description": "Update ID of the Canton update containing the transfer.",
"nullable": true
},
"senderParty": {
"type": "string",
"description": "Full Canton sender party ID. Null when not applicable.",
"nullable": true
},
"receiverParty": {
"type": "string",
"description": "Full Canton receiver party ID. Null when not applicable.",
"nullable": true
},
"providerParty": {
"type": "string",
"description": "Full Canton provider party ID. Null when not applicable.",
"nullable": true
},
"amount": {
"type": "string",
"description": "Canton Coin amount, as a decimal string. Null when unavailable.",
"nullable": true
},
"transferType": {
"type": "string",
"description": "Public transfer category.",
"nullable": true
},
"status": {
"type": "string",
"description": "Transfer status. Null when unavailable.",
"nullable": true
},
"trafficCostCc": {
"type": "string",
"description": "Traffic cost in Canton Coin, as a decimal string. Null when unavailable.",
"nullable": true
},
"trafficCostUsd": {
"type": "string",
"description": "Traffic cost in USD, as a decimal string. Null when unavailable.",
"nullable": true
},
"trafficUnits": {
"type": "integer",
"description": "Traffic units purchased. Null when not a traffic purchase.",
"format": "int64",
"nullable": true
},
"numPurchases": {
"type": "integer",
"description": "Number of traffic purchases represented by the item. Null when not applicable.",
"format": "int64",
"nullable": true
}
},
"additionalProperties": false,
"description": "One Canton Coin transfer or traffic purchase."
},
"TransfersResponseDto": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TransferItemDto"
},
"description": "Transfers returned in this page.",
"nullable": true
},
"hasMore": {
"type": "boolean",
"description": "True when another page is available."
},
"nextCursor": {
"type": "string",
"description": "Opaque cursor for the next page. Null when `hasMore` is false.",
"nullable": true
},
"nextPageUrl": {
"type": "string",
"description": "Complete URL for the next page. Null when `hasMore` is false.",
"nullable": true
},
"totalTrafficPurchased": {
"type": "integer",
"description": "Total traffic units purchased in the requested window. Null when totals are unavailable.",
"format": "int64",
"nullable": true
},
"totalUsdSpent": {
"type": "string",
"description": "Total USD spent on traffic purchases in the requested window, as a decimal string. Null when unavailable.",
"nullable": true
},
"totalPurchases": {
"type": "integer",
"description": "Total number of traffic purchases in the requested window. Null when unavailable.",
"format": "int64",
"nullable": true
}
},
"additionalProperties": false,
"description": "One page of Canton Coin transfers involving a party."
}
}
}
}
```