---
title: "Canton Synchronizer Traffic-Cost Calculator"
method: POST
path: "/v1/tools/compute_canton_traffic_cost"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Canton Synchronizer Traffic-Cost Calculator

`POST /v1/tools/compute_canton_traffic_cost`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_canton_traffic_cost`
- Auth: none declared

Computes Canton Network synchronizer traffic cost (CIP-0042/CIP-0084 regime): fee = message megabytes x the Tokenomics-Committee-set USD/MB rate, converted to Canton Coin burned at a caller-supplied CC/USD price. Applies the CIP-0119 transfer-preapproval free-traffic window (90-day base duration since June 2026) when the traffic is a preapproval within its free period. Rate, price, and protocol-version inputs are caller-supplied and source-cited in the output -- this kernel never hard-codes a fee or price as a silent constant. Distinct from the shipped tokenization-readiness/DvP/allowlist Canton nodes (503/507/509), which validate settlement and counterparty structure rather than compute synchronizer traffic economics.

**Tool URL:** https://ainumbers.co/chaingraph/art-391-compute-canton-traffic-cost.html

## Request body

- object
  - `cc_usd_price` number
  - `envelope_mb` number
  - `is_transfer_preapproval` boolean, required
  - `preapproval_age_days` number: Duration in days
  - `protocol_version` unknown, required
  - `rate_usd_per_mb` number

## Response `200`

Successful tool execution result

- object
  - `cc_burned` integer
  - `cc_usd_price` number
  - `disambiguation` string
  - `effective_rate_usd_per_mb` integer
  - `envelope_mb` number
  - `free_period_applies` boolean
  - `free_period_days` integer
  - `free_period_source` string
  - `is_transfer_preapproval` boolean
  - `preapproval_age_days` integer
  - `protocol_version` string
  - `rate_source` string
  - `rate_usd_per_mb` integer
  - `usd_traffic_cost` integer

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)