Skip to content

Cost

Overview

A cost record captures a financial transaction related to the artwork — the original acquisition price, a restoration fee, an insurance premium, a framing cost, or any other expense the owner wants to track. The system supports multiple currencies and normalizes all amounts to USD for consistent reporting.

Cost records are part of the back card (vault). They are strictly private to the owner.


Fields

FieldWhat it represents
DescriptionWhat this cost was for — purchase, restoration, insurance, shipping, etc.
Cost dateWhen this cost was incurred
CurrencyThe currency in which the cost was originally paid
Currency code at time of recordingThe currency code as it was at the time of recording (stored for historical accuracy)
Amount (net)The amount in the original currency
Amount (USD)The amount normalized to US dollars at the time of recording
TaxAny tax amount associated with this cost, tracked separately from the net amount

Business Rules

  1. Cost records are private — only the current owner can see and manage them.

  2. When a cost is recorded, the amount is stored in both the original currency and USD. The USD conversion uses the exchange rate at the time the record is created.

  3. Tax is stored separately from the net amount so owners can distinguish the base cost from applicable taxes.

  4. Costs are not included in a transfer by default. The sender may explicitly opt in to share them. See Transfer.


Constraints

  • Cost data is never included in public or social feed queries.
  • There is no limit on the number of cost entries a card can have.