Attestify OS
Quickstart
Builder PlansAgent ControlsLive TransactionsLIVEDashboardAttestify RiskNewSentinelX402 · Pay Per CallDocsDemo
Home·Basis
Attestify Basis · preview

A tokenized stock is not the same asset with longer hours

Once a share trades as an on-chain token, it can be demanded for reasons that have nothing to do with owning the stock — as collateral, as a quote asset, as a routing hop. When the underlying market is shut, the wrapper can trade well away from the value of the shares behind it. Attestify Basis measures that gap and publishes it as data.

Basis vs. reference, effective float, issuer proof-of-backing, and underlying market state — one free endpoint per wrapper, plus a signed attestation object for on-chain consumption.

Reading this as an agent, not a human? Machine-readable summary: /llms-basis.txt
contract: GET /api/basis/v1 — self-describing, free, no auth
coverage: GET /api/basis/v1/symbols — wrappers reported on
quote: GET /api/basis/v1/quote/:symbol — basis_pct, effective_float, borrow, underlying_state, observations[]
attestation: GET /api/basis/v1/attestation/:symbol — signed point-in-time snapshot + proof-of-backing restatement
status: preview — shapes stable, values illustrative, nothing metered
boundary: data for licensed parties to act on — not advice, not a broker/exchange, no custody

What Basis measures

Four fields per wrapper, each with the context needed to read it. Full field-by-field definitions are in the methodology.

basis_pct
Basis vs. reference

The signed gap between the wrapper’s on-chain price and an off-chain reference for the same shares. Positive means the wrapper is trading rich. Reported in percent and basis points, with the reference derivation stated.

effective_float
Effective float

An estimate of how much wrapper inventory is available near the reference price before additional arbitrage capital arrives — with a confidence level. A wide basis on top of thin float is a very different state from a wide basis on deep float.

backing
Proof-of-backing, restated

The wrapper issuer’s own latest reserve report, restated with its evidence trail — source, retrieval time, content hash. Basis does not audit the issuer; it attests to what the issuer published and where it came from.

underlying_state
Underlying market state

Whether the market for the underlying shares is open, closed, halted, or on holiday. The same basis means something different at 2am Sunday than at 10am Tuesday, and consumers need that context.

How this fits with the rest of Attestify

TrustSigns and verifies evidence about what an agent did. Basis reuses the same Ed25519 signing envelope for its attestation objects.
EarnLicenses the aggregate of attested agent activity to vetted buyers. The Basis historical dataset — basis and effective-float over time — is distributed through Earn.
RiskGoverns and audits spend flowing through Attestify. Basis is a data input a risk system can consume, not a governance surface itself.
BasisMeasures tokenized-equity wrappers against the shares behind them and publishes the result as structured data + signed attestations. Consumed by lending protocols, DEX and router frontends, wallets, and risk desks.

Why the gap opens

Tokenizing a share creates a new, application-layer demand curve for it: it can be used as collateral, as a liquidity pair, or as the quote asset for an unrelated token that routes through it. That demand shows up whether or not the underlying market is open.

Supply is slower. New wrapper inventory is created and redeemed on the issuer’s schedule, and arbitrage capital that would close a gap may not be positioned at 2am on a Sunday. So demand shows up as price instead of quantity — until it doesn’t. Basis exists to make that state legible before something is priced against it, and to keep a signed record of what the gap was at a given moment.

Quick start

Read a basis reading — no key requiredFull reference →
curl https://attestifyos.com/api/basis/v1/quote/AAPLx

# → { basis_pct, basis_bps, effective_float, borrow,
#     underlying_state, observations[], preview: true }
Embed the pre-trade warning@attestify/basis-guard →
import { BasisGuard } from '@attestify/basis-guard';

// Renders "the token you are quoting against is trading
// N% above its reference value" when the basis breaches
// your threshold. Free tier by default.
<BasisGuard symbol="AAPLx" warnAtBps={150} />

The drop-in example lives at examples/github/basis-guard.tsx. Preview responses are flagged preview: true — build against the shape now, the values go live with the pipeline.

Coverage

12 wrappers at launch, served live from /api/basis/v1/symbols and growing as issuers are onboarded. Listing is illustrative coverage, not an endorsement of any issuer or token.

AAPLx · AAPLTSLAx · TSLANVDAx · NVDAMSTRx · MSTRCOINx · COINHOODx · HOODGOOGLx · GOOGLAMZNx · AMZNMETAx · METACRCLx · CRCLSPYx · SPYQQQx · QQQ

What Basis is and isn’t

  • Basis publishes measurements and attestations as structured data, for licensed parties and protocol integrators to act on.
  • It does not custody assets, execute or facilitate trades, route orders, or hold funds.
  • It is not a broker-dealer, exchange, or investment adviser, and nothing it publishes is a recommendation, a price prediction, an offer, or a solicitation.
  • The API returns no verdict field — no safe_to_quote, no accept/reject boolean. It publishes the measured fields and neutral observations[]; any threshold for acting on them is the integrator’s.
  • The attestation restates an issuer’s own published reserve report with its evidence trail. It is not a solvency opinion, an audit, or a rating of the issuer.

Questions

Is this investment advice or a trading signal?

No. Basis publishes measurements and attestations as structured data. It makes no recommendation to buy, sell, or hold anything, predicts no prices, and is not a broker-dealer, exchange, or investment adviser. The API returns no accept/reject verdict — only the measured fields and neutral observations. Any threshold for acting on them is set by the integrator.

What is the reference price and where does it come from?

Every response states how the reference was derived. The target design is a multi-source composite — several wrapper venues plus underlying/ETF proxies — rather than a single feed, both for resilience and to avoid a single-vendor redistribution dependency. In preview the reference is synthetic and flagged as such.

How is “effective float” calculated?

It estimates the wrapper inventory available within a tight band of the reference price before additional arbitrage capital would need to arrive, expressed in USD with a confidence level and the band width used. The methodology is documented at /docs/basis/methodology and versioned in the open spec repo.

What does the attestation object contain, and is it signed?

A point-in-time snapshot (wrapper price, reference price, basis in bps, underlying state) plus the issuer proof-of-backing restatement with its evidence trail, wrapped in an Ed25519 signature over the canonicalized object — the same signing primitive Attestify Trust uses for receipts. It is suitable for on-chain oracle consumption and audit. In preview the signature is a clearly-marked placeholder.

Is it free?

The quote and symbols endpoints and the embeddable widget are free — a low rate limit unauthenticated, higher with a free API key. Higher volume, websocket delivery, historical data, and the issuer attestation service are paid. Nothing is metered during preview.

Which wrappers are covered?

The live list is served from /api/basis/v1/symbols and grows as wrapper issuers are onboarded. Symbols shown on this page are illustrative coverage, not an endorsement of any issuer or token.

Build against the contract today

The API shape is stable in preview. Wire it in now, and the readings go live when the ingestion pipeline does.