Free lesson · On-chain markets

Raw token amounts and economic event types

Open interactive lessonPractice calculationsExplore labs

An event log records what a contract emitted. It does not automatically tell you who economically traded, what currency value changed or whether ownership changed.

Normalize raw integer amounts using token decimals verified at the relevant contract/version. Identify chain, block hash, transaction hash and event index to avoid duplicate logs.

Classify swaps, transfers, mints, burns and bridge operations separately. A transfer count can include self-transfers or exchange wallet management. Keep raw records so classifications can be audited and revised.

Apply it in a strategy

• Build a data manifest with token units and economic event categories before estimating volume or wallet activity.
• Record the input timestamp, executable quantity, currency and horizon. Reconcile the result with a cash-flow or state table.
• Stress this failure condition: Wrong decimals, duplicated logs and address-as-person assumptions can produce enormous but meaningless metrics.

Research deliverable

Build and explain a raw token amounts and economic event types worksheet. Build a data manifest with token units and economic event categories before estimating volume or wallet activity.

Evidence boundary: Synthetic arithmetic and scenarios illustrate mechanics. They are not historical returns, a paper replication, or evidence of an executable edge. Research sources and their access limitations are recorded at the end of this module.

Research sources, review dates and limitations

# Python 3.10+; standard library unless NumPy is imported below.
# Inputs and outputs use the units defined in this lesson. Synthetic teaching example.
from decimal import Decimal
def token_units(raw,decimals):
    if not isinstance(raw,int) or raw<0 or not isinstance(decimals,int) or decimals<0: raise ValueError("Integer raw amount and decimals required")
    return Decimal(raw)/(Decimal(10)**decimals)

print(token_units(1250000,6))