Trust metadata

Trust metadata answers four questions about a single field: where the value came from, how old it is, whether it matches what Polymarket reported, and whether it covers everything it is meant to. Read it before you let an automated action depend on one number.

Request it

Pass expand=trust. Without it, the trust object is not in the response at all.

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/trader/swisstony?expand=trust"

Route	Fields inside `trust`
Trader, Batch traders	19: `total_pnl`, `realized_pnl`, `unrealized_pnl`, `markets_traded`, `win_rate`, `daily_win_rate`, `total_volume`, `grade`, `score`, `rank`, `streak_tier`, `strategy`, `category_strengths`, `category_records`, `category_skill_model`, `quant_metrics`, `last_active`, `synced_at`, `sync_status`.
Market snapshot	2: `current_price`, `spread_bps`.

Pick of the Day also returns a trust object, with the single field qualifying_expert. It is the one route that returns trust metadata without an expand, and only on the full pick.

The shape

{
  "trust": {
    "total_pnl": {
      "source": { "kind": "provider", "owner": "traders", "field": "total_pnl" },
      "freshness": { "status": "fresh", "as_of": "2026-08-28T14:28:20Z" },
      "reconciliation": { "status": "provider_backed" },
      "completeness": { "status": "complete" }
    },
    "grade": {
      "source": { "kind": "computed", "owner": "0xinsider_trader_read_model", "field": "grade" },
      "freshness": { "status": "unknown" },
      "reconciliation": { "status": "computed", "detail": "derived from stored provider-backed trader, position, and market facts" },
      "completeness": { "status": "complete" }
    }
  }
}

kind, owner, and all four status values are always present. owner names the store or service the value came from, and field names the column or provider field inside it. The optional keys are field, as_of, max_age_s, and detail. When there is nothing to report, each one is left out of the JSON rather than set to null, so read them with a default. On a trader, total_pnl, markets_traded, and total_volume are the values Polymarket reported. Everything else 0xinsider computed or copied from its own stored records.

`source.kind`

Value	What it means
`provider`	The value came from Polymarket.
`database`	The value came from a stored 0xinsider record.
`cache`	The value came from a short-lived cache.
`computed`	0xinsider derived the value from stored records.
`client_input`	The value is echoed back from your own request.
`unavailable`	No source could supply the field.

`freshness.status`

Value	What it means
`fresh`	An `as_of` timestamp is known and the value is still inside its window.
`refreshing`	A newer value is being fetched now.
`stale`	The value is past its window.
`not_live`	The value is a point in time and is never meant to update.
`unknown`	Nothing tracks how old this value is.
`unavailable`	The value itself could not be supplied.

as_of is when the value was last known to be correct. max_age_s is how many seconds after as_of a fresh value becomes stale. On a trader, no field carries max_age_s, so there is no window to compare against. fresh there only means a sync timestamp exists, and as_of is that timestamp, so read the timestamp rather than the word. Computed fields such as grade, score, and quant_metrics report unknown, so do not require fresh on them.

`reconciliation.status`

Value	What it means
`provider_backed`	The value matches what Polymarket reported.
`db_mirror`	The value was copied from an earlier Polymarket read and was not read again for this request.
`computed`	0xinsider derived the value, and there is no single Polymarket field to compare it against.
`partial`	The value was compared against some sources but not all of them.
`not_applicable`	Reconciliation does not apply to this field.
`unavailable`	No comparison was possible.

`completeness.status`

Value	What it means
`complete`	The value covers everything the field promises.
`partial`	The value covers part of it, such as a fallback value or a sync still running.
`not_computed`	Nothing was computed for this request, for example a field you did not expand.
`not_applicable`	Completeness does not apply to this field.
`unavailable`	Completeness could not be determined.

Gate an automated action

Reject the value when source.kind is unavailable.
Reject the value when completeness.status is partial or unavailable.
For a provider or database value, require freshness.status to be fresh, then check as_of against your own deadline.
For a computed value, accept freshness.status of unknown. That is the normal answer there.

Never substitute 0, [], or {} for a value marked unavailable. Show the reader that it is unavailable instead.

What this does not tell you

That the value is correct. provider_backed means it matches what Polymarket last reported, and computed means 0xinsider derived it from stored records.
How old a trader value is, from the status word alone. Only as_of answers that.
Anything at all without the expand. A request without expand=trust returns the same numbers and no metadata beside them.

Getting started

Integrations

Guides

Concepts

Request it

The shape

`source.kind`

`freshness.status`

`reconciliation.status`

`completeness.status`

Gate an automated action

What this does not tell you

​Request it

​The shape

​source.kind

​freshness.status

​reconciliation.status

​completeness.status

​Gate an automated action

​What this does not tell you

Request it

The shape

`source.kind`

`freshness.status`

`reconciliation.status`

`completeness.status`

Gate an automated action

What this does not tell you