# Attestify Basis — What a Tokenized Stock Is Actually Worth # Machine-readable capability summary for LLM and agent discovery # Human-readable landing page: coming soon at https://attestifyos.com/basis # Open spec: https://github.com/attestifyagent/basis # Status: PREVIEW — API contract, endpoint set, and response shapes are # stable and safe to build against. Returned values are illustrative and # flagged `preview: true` until the ingestion pipeline (wrapper venue # price, reference composite, issuer reserve reports, lending-market # borrow data) is production-wired. No endpoint is metered in preview. # Open spec repo: https://github.com/attestifyagent/basis # Last updated: 2026-09-01 --- ## What is Attestify Basis? Attestify Basis is the measurement and attestation layer for tokenized-equity wrappers — on-chain tokens that represent exposure to a public stock or ETF. Once a share trades as a token, it can be demanded for reasons unrelated to owning the stock: as collateral, as a liquidity pair, as the quote asset for an unrelated token that routes through it. That demand does not stop when the underlying market closes, but wrapper supply responds on a slower schedule — so the wrapper can trade well away from the value of the shares behind it. Basis measures that gap and publishes it as structured data plus signed attestations: - basis vs. an off-chain reference (signed, in percent and basis points) - effective float — wrapper inventory available near reference before arbitrage capital arrives - the issuer's proof-of-backing, restated with its evidence trail - underlying market state (open / closed / halted / holiday) --- ## Legal boundary Basis operates in Layer 2 of Attestify's three-layer model (see /LEGAL_BOUNDARY.md). Every output is data for licensed parties and protocol integrators to act on. - Basis does NOT custody assets, execute or facilitate trades, route orders, or hold funds. - Basis is NOT a broker-dealer, exchange, or investment adviser. - Nothing Basis 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 plus neutral `observations[]`; any threshold for acting on them is set by the consumer. Reference client-side thresholding is in @attestify/basis-guard (warnAtBps, requireOpen). - 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. - Wrapper symbols listed are illustrative coverage, not an endorsement of any issuer or token. --- ## Endpoints - GET /api/basis/v1 Self-describing service contract. Free, no auth. Lists every endpoint, every response shape, the disclaimer, and the coverage seed. - GET /api/basis/v1/symbols Coverage list — every wrapper symbol Basis reports on, with its underlying ticker, issuer, the chains it trades on, and the quote/attestation endpoint paths for each. - GET /api/basis/v1/quote/:symbol The current basis reading for one wrapper: { symbol, underlying, chain, as_of, wrapper_price, reference_price, reference_source, basis_pct, basis_bps, effective_float: { near_reference_usd, band_bps, confidence }, borrow: { available, rate_apr, source }, underlying_state, observations[], preview } No verdict field. Free, no auth (higher rate limit with a free API key). CORS-open — this is what the @attestify/basis-guard widget polls. - GET /api/basis/v1/attestation/:symbol A signed, point-in-time attestation object (schema: basis-attestation/v1): { schema, symbol, chain, as_of, snapshot: { wrapper_price, reference_price, basis_bps, underlying_state }, backing: { issuer, ratio, report_url, report_as_of, restated_by, evidence }, signature: { alg: "ed25519", key_id, value, canonicalization }, disclaimer, preview } Signing reuses the same Ed25519 primitive as Attestify Trust receipts, so any consumer that verifies Trust receipts can verify Basis attestations. Suitable for on-chain oracle consumption and audit. In preview the key_id is a marked placeholder. --- ## Oracle behaviour when the underlying market is closed When underlying_state != 'open', the attestation snapshot does NOT echo the wrapper's last on-chain trade as a price. It reports reference_price (the stale-session mark), basis_bps (how far the wrapper has moved from it), and the explicit underlying_state flag, and effective_float.confidence is capped at 'medium'. A consumer using this in a liquidation or LTV calculation gets the reference plus an explicit staleness signal instead of a number tracking a thin weekend market. --- ## Pricing - Free: quote + symbols endpoints, and the @attestify/basis-guard embeddable widget. Low rate limit unauthenticated, higher with a free API key. - Paid: higher rate limits, websocket delivery, historical basis / effective-float series (distributed via Attestify Earn), and the issuer proof-of-backing attestation service. - Nothing is metered during preview. --- ## Coverage Seed coverage is Backed Finance's xStocks line (AAPLx, TSLAx, NVDAx, MSTRx, COINx, HOODx, GOOGLx, AMZNx, METAx, CRCLx, SPYx, QQQx), primary venue Solana, several also on Base. Priority is observability: a wrapper is covered when its basis can be measured without the issuer's cooperation (composable ERC-20 / SPL on public venues). Wrappers on permissioned chains are issuer design-partner work, not day-one scrape coverage. Live list: GET /api/basis/v1/symbols. ## Related - Product page: coming soon at https://attestifyos.com/basis - Methodology: https://github.com/attestifyagent/attestify-os/blob/main/docs/basis/methodology.md - Open spec repo: https://github.com/attestifyagent/basis - Drop-in widget example: examples/github/basis-guard.tsx in github.com/attestifyagent/attestify-os - Attestify Trust (shared signing primitive): https://attestifyos.com/trust - Attestify Earn (historical dataset distribution): https://attestifyos.com/earn Tags: basis, tokenized-equities, stock-tokens, wrapper-basis, nav-oracle, effective-float, proof-of-backing, proof-of-reserves, premium-discount, tokenization, base, defi-oracle, pre-trade-check