Number formatting

Most display values on this API are JSON numbers cut to a fixed number of decimal places. The cut always moves toward zero, so an API value is never larger in size than the stored value. It can be smaller by less than one unit of its last decimal place. The trader profile and positions routes also expose additive exact decimal atoms for selected financial values when their verified source exists.

Decimal places

What it is	Places	Examples
Money	2	`pnl.total`, `pnl.realized`, `size_usd`, `total_volume`, `net_flow_usd`
Wallet score	2	`score`
Rates	4	`win_rate`, `daily_win_rate`
Prices	4	`price`, `avg_price`, and the candle fields `o`, `h`, `l`, and `c`
Trade score	4	`review_score`, `recorded_review_score`, and their deprecated twins `signal_score`, `recorded_signal_score`

Cutting toward zero means the digits past the limit are dropped, not rounded. 97.9488 becomes 97.94, and -12.345 becomes -12.34. The numbers inside quant_metrics are the exception. They are passed through exactly as computed, with no cut. See Quant metrics.

Integer fields

These come back as whole numbers with no decimal point.

Field	Where you see it
`markets_traded`	A leaderboard entry, a market holder, a Pick of the Day holder, and `stats.markets_traded` on a trader.
`rank`	A trader, a trending wallet, a sports edge signal, and a sports edge observation.
`whale_trade_count`	The `sharp_money` object on market intel and the two flow routes.
`event_leg_count`	A large position.
`suspicion_score`	A whale trade. On a Suspicious trades flag the same name is a decimal, not an integer.

Exact decimal atoms

GET /api/v1/trader/{address} adds pnl.exact.realized and stats.exact.total_volume. GET /api/v1/positions adds an exact object to each valued position. An atom has this shape:

{
  "value": "-1882.161234",
  "unit": "USD",
  "scale": 6,
  "basis": "trader_trading_pnl.net_realized_pnl"
}

value is decimal text from the verified source value, unit identifies what it measures, scale preserves the source decimal scale, and basis names the source field or derivation. The existing numeric twin remains the display field. Parse value with a decimal type and never reconstruct an exact value from that numeric twin. The exact block or an optional atom is omitted when its source is unavailable; omission is not zero. The position route uses shares, USD, and USD/share units for the corresponding exact fields. avg_price is derived with decimal arithmetic from the exact cost basis and exact shares, and is omitted when that derivation cannot be made.

Exact decimals sent as strings

Counterparty makers and Counterparty executions return filled_shares and filled_usdc as decimal strings rather than JSON numbers. Parse them with a decimal type, not a float, or you will lose the last digits.

Display strings on Pick of the Day

Pick of the Day and its archive return pre-formatted strings next to the numbers they came from. The number is the value to compute with, and the string is only for display. No other endpoint returns these.

Source number	Display string	Format
`backed_price`	`odds_display`	Cents to one decimal, as in `"62.0c"`. Never rounded to a whole cent.
`return_usd`	`payout_display`	The gross return in USD with the stake included, as in `"$1,612.90"`.
`return_usd`	`profit_display`	The signed profit on the stake in USD, as in `"+$612.90"`.
`outcome`	`outcome_display`	`"Win"`, `"Loss"`, `"Void"`, or `"Pending"`.
`unit_score`	`unit_score_display`	Signed, in stake units to two decimals, as in `"+1.24u"`.
`clv_pct`	`clv_display`	A signed percentage.

The archive’s hit_rate object carries its own set, and so does each archive row and each archive day.

Source number	Display string	Format
`hit_rate.net_profit_usd`	`net_profit_display`	Signed whole dollars, as in `"+$1,000"`.
`hit_rate.roi_pct`	`roi_display`	Signed, to one decimal, as in `"+8.3%"`.
`hit_rate.pct`	`win_rate_display`	To one decimal and unsigned, as in `"92.3%"`.
`hit_rate.unit_score`	`unit_score_display`	Signed, in stake units to two decimals, as in `"+1.25u"`.
`hit_rate.clv_avg_pct`	`clv_avg_display`	A signed percentage.
`hit_rate.clv_avg_pp`	`clv_avg_pp_display`	Signed percentage points, as in `"+0.4 pp"`.
`hit_rate.clv_coverage_pct`	`clv_coverage_display`	The percentage of applicable picks that have a measured closing-line value.

net_profit_display and roi_display are rounded first and signed afterwards, so a record that rounds to zero reads "+$0" or "+0.0%" and never shows a negative zero.

Handle a missing value

A field with no value is usually left out of the JSON rather than sent as null, so read those fields with a default and never read a missing key as zero.

Case	What to do
`grade`, `score`, `streak_tier`, `strategy_type`, and every value under `pnl` and `stats`	Each one is absent when 0xinsider has no value for it. A missing key is not a zero.
`pnl.realized` absent	Polymarket has no realized figure for the wallet. Never put `pnl.total` in its place, because it includes open positions.
A `null` inside `quant_metrics`	The key is present and its value is `null`. The wallet has too little history for that number, so do not turn it into `0`.
`recorded_review_score`, `recorded_signal_score`, `suspicion_score`, `outcome`, and `token_id` on a large trade	These are sent as `null` when there is no value, rather than being left out.
A field marked `unavailable` or `partial` under `expand=trust`	Do not replace the value with `0`, `[]`, or `{}`. See Trust metadata.

What this does not tell you

An exact reconciliation. Adding up cut values drifts away from the stored total, so compute from the source data when cents matter.
How many decimals are stored. The API returns 2 or 4 places whatever the stored value holds.
A display string anywhere outside Pick of the Day. Every other route returns the number alone.

Getting started

Integrations

Guides

Concepts

Decimal places

Integer fields

Exact decimal atoms

Exact decimals sent as strings

Display strings on Pick of the Day

Handle a missing value

What this does not tell you

​Decimal places

​Integer fields

​Exact decimal atoms

​Exact decimals sent as strings

​Display strings on Pick of the Day

​Handle a missing value

​What this does not tell you

Decimal places

Integer fields

Exact decimal atoms

Exact decimals sent as strings

Display strings on Pick of the Day

Handle a missing value

What this does not tell you