Objetos

Instrument

Esta referência está em inglês. A navegação e os rótulos estão traduzidos.

One yield-bearing position: a lending market, vault or staking pool, with its yield, liquidity, safety score and screen verdict.

Objeto: instrumentPrefixo do id: ins_

Campos

Every instrument in the daily screen is returned, passed and failed. Failed instruments carry the first hard rule they failed in screen.failed_rule.

Free accounts get preview rows: real totals and up to 5 rows, with passing instruments reduced to asset_class, venue.chain, yield.total_apy, liquidity.tvl, safety.band and screen.verdict, a placeholder id ("redacted_1", …) and redacted: true. Failing instruments are returned in full.

objectstring
Always "instrument".
idstring
Stable id: "ins_" and 16 hex characters. The same instrument keeps its id across days.
namestring
Asset label as depositors know it, e.g. "USDC".
detailstringpode ser null
Extra label from the venue, e.g. a vault or market name.
asset_classenum
What the instrument holds. Reports cover stablecoin, bitcoin, ether and xrp.
Valores:stablecoinbitcoinetherxrpother
exposureobject
What a depositor is exposed to.
exposure.single_assetboolean
True when the position holds one asset (no pair).
exposure.stable_onlyboolean
True when every asset in the position is a stablecoin.
exposure.impermanent_lossboolean
True when the position can lose value to price divergence between its assets.
venueobject
Where the instrument lives.
venue.protocolobject
The protocol that runs the instrument.
venue.protocol.idstring
Protocol id, "prt_" and a slug. Use it with GET /protocols/{id}.
venue.protocol.namestring
Protocol display name.
venue.chainobject
The chain the instrument is deployed on.
venue.chain.idstring
Chain id, lowercase with dashes, e.g. "ethereum", "op-mainnet".
venue.chain.namestring
Chain display name.
venue.urlstringpode ser null
The protocol's own app page for this instrument, when known.
yieldobject
Annualised yield, in percent (8.13 = 8.13%).
yield.total_apynumber · percent
Total yield: native plus incentive.
yield.native_apynumber · percent
Organic yield from interest, staking or fees.
yield.incentive_apynumber · percent
Yield paid in incentive tokens.
yield.incentive_sharenumber · 0–1
Share of total_apy paid in incentives.
yield.trailing_7d_apynumber · percentpode ser null
Average total APY over the last 7 days.
yield.trailing_30d_apynumber · percentpode ser null
Average total APY over the last 30 days.
yield.change_1d_ppnumber · pppode ser null
Change in total APY over 1 day, percentage points.
yield.change_7d_ppnumber · pppode ser null
Change in total APY over 7 days, percentage points.
yield.change_30d_ppnumber · pppode ser null
Change in total APY over 30 days, percentage points.
yield.consistency_30dnumber · 0–1pode ser null
How steady the yield was over 30 days. Higher is steadier.
yield.realized_30d_apynumber · percentpode ser null
Yield measured by simulated deposits and withdrawals, 30-day average.
yield.realized_confidenceenumpode ser null
Confidence in realized_30d_apy.
Valores:highmediumlowconflicting
liquidityobject
Size, depositors and the simulated exit.
liquidity.tvlnumber · USD
Total value locked.
liquidity.volume_24hnumber · USDpode ser null
Trading volume over the last 24 hours, where it applies.
liquidity.depositor_countintegerpode ser null
Number of depositors.
liquidity.top10_concentrationnumber · 0–1pode ser null
Share of deposits held by the ten largest depositors.
liquidity.exitobject
Result of the latest simulated withdrawal.
liquidity.exit.stateenumpode ser null
Whether a withdrawal could exit. null when no simulation is on record.
Valores:instantqueuedpartialdrainedunavailableblocked
liquidity.exit.eta_secondsinteger · secondspode ser null
Expected wait before funds arrive, for queued exits.
liquidity.exit.capacitynumber · USDpode ser null
Amount that could be withdrawn at the time of the simulation.
safetyobject
The safety score and what moved it.
safety.scoreintegerpode ser null
0–100, higher is safer. Starts at 100; each signal deducts points. null only for picks of reports published before the scoring engine.
safety.bandenum
low ≥ 80, moderate 60–79, high < 60.
Valores:lowmoderatehigh
safety.signalsobject[]
Soft signals that lowered the score, largest impact first.
safety.signals[].codeenum
Signal code. Descriptions are in GET /methodology.
Valores:no_audit_on_recordunknown_protocolprior_incidentyoung_protocolyoung_instrumentexit_queuepartial_exitexit_unverifiedrealized_below_advertisedincentive_dependentvolatile_yieldconcentrated_depositorssmall_tvlelevated_apy
safety.signals[].impactinteger
Points deducted from the score (negative).
safety.auditobject
Audits on record for the protocol.
safety.audit.on_recordboolean
True when at least one audit is on record.
safety.audit.countinteger
Number of audits on record.
safety.audit.linksstring[]
Links to the published audit reports.
safety.incidentsobject
Security incidents on record for the protocol.
safety.incidents.countinteger
Number of incidents on record.
safety.incidents.last_atstring · YYYY-MM-DDpode ser null
Date of the most recent incident.
safety.incidents.total_lostnumber · USD
Total amount lost across incidents.
safety.protocol_age_daysinteger · dayspode ser null
Days since the protocol launched.
screenobject
Outcome of the daily screen for this instrument.
screen.verdictenum
pass, or fail when a hard rule excluded it.
Valores:passfail
screen.failed_ruleenumpode ser null
First hard rule the instrument failed. null when verdict is pass.
Valores:tvl_floorapy_floorapy_ceilingout_of_scopeimpermanent_lossrecent_incidentexit_blockedunaudited_smallunverified_yieldscore_floor
screen.in_reportboolean
True when the instrument is in today's report (top 5 of its asset class).
screen.report_rankintegerpode ser null
Rank in the report section, 1–5.
screen.first_seenstring · YYYY-MM-DD
First screen that saw this instrument.
as_ofstring · ISO 8601
Time of the screen these values come from.

Exemplo

{
  "object": "instrument",
  "id": "ins_4c29f40abec73e1b",
  "name": "USD3",
  "detail": "USD3",
  "asset_class": "stablecoin",
  "exposure": {
    "single_asset": true,
    "stable_only": true,
    "impermanent_loss": false
  },
  "venue": {
    "protocol": {
      "id": "prt_3jane-lending",
      "name": "3Jane Lending"
    },
    "chain": {
      "id": "ethereum",
      "name": "Ethereum"
    },
    "url": "https://app.3jane.xyz/supply"
  },
  "yield": {
    "total_apy": 6.72786,
    "native_apy": 6.72786,
    "incentive_apy": 0,
    "incentive_share": 0,
    "trailing_7d_apy": 6.68821,
    "trailing_30d_apy": 6.65611,
    "change_1d_pp": 0.03629,
    "change_7d_pp": 0.04312,
    "change_30d_pp": -0.03221,
    "consistency_30d": 0.98032,
    "realized_30d_apy": 6.6582611446569295,
    "realized_confidence": "high"
  },
  "liquidity": {
    "tvl": 92211394,
    "volume_24h": null,
    "depositor_count": 798,
    "top10_concentration": 0.8919,
    "exit": {
      "state": "instant",
      "eta_seconds": null,
      "capacity": 10699293.675298352
    }
  },
  "safety": {
    "score": 90,
    "band": "low",
    "signals": [
      {
        "code": "concentrated_depositors",
        "impact": -5
      },
      {
        "code": "small_tvl",
        "impact": -5
      }
    ],
    "audit": {
      "on_record": true,
      "count": 2,
      "links": ["https://docs.3jane.xyz/resources/audits"]
    },
    "incidents": {
      "count": 0,
      "last_at": null,
      "total_lost": 0
    },
    "protocol_age_days": 414
  },
  "screen": {
    "verdict": "pass",
    "failed_rule": null,
    "in_report": true,
    "report_rank": 4,
    "first_seen": "2026-10-23"
  },
  "as_of": "2026-10-23T23:45:21.116Z"
}

Campos

Endpoints