LedgerOne
LedgerOne
DOCS
Docs Explorer Pricing About
Search docs… ⌘K
API Reference
{{ g.h }}
DOCS / GETTING STARTED

Introduction

LedgerOne is the trust layer for real-world assets on Robinhood Chain. It verifies who may hold an asset, records what the asset is, and proves what it is worth and what backs it — then exposes all of it through dashboards, APIs and webhooks.
{{ qc.t }}
{{ qc.d }}
{{ qc.cta }} →

Quickstart

Fetch the verified NAV of an asset in three steps. All endpoints are versioned under https://api.buildledgerone.xyz/v1.
{{ st.n }}
{{ st.t }}
{{ st.d }}
{{ st.lang }}
copy
{{ st.code }}

Authentication

Every request is authenticated with a scoped API key sent in the Authorization: Bearer header. Keys are issued per environment (sandbox / production) from the Developer Portal, carry explicit scopes, and can be rotated without downtime.
{{ sc.s }}
{{ sc.d }}

Environments

Sandbox
https://api.sandbox.buildledgerone.xyz/v1
Test assets, simulated oracles, instant fake attestations. Keys prefixed lo_sandbox_. Free on every plan.
Production
https://api.buildledgerone.xyz/v1
Live verified data. Keys prefixed lo_live_, issued after workspace approval. All access audit-logged.

The Trust Layer

LedgerOne sits between real-world operations and Robinhood Chain as five coordinated layers. Data flows up; proofs anchor down.
{{ tl.l }}
{{ tl.l }}
{{ sel.l }} · {{ sel.tag }}
{{ sel.name }}
{{ sel.d }}
{{ it }}

Asset lifecycle

An asset may only move to ACTIVE when four gates pass: minimum legal documents in the Vault, at least one valid PoR attestation, a configured oracle source, and platform approval (maker–checker).
{{ stt.s }}
{{ stt.d }}

Transfer compliance

Six rules run in strict order before any transfer settles. The first failure rejects the transfer with a standardized reason code.
{{ r.n }}
{{ r.name }}
{{ r.d }}
{{ r.code }}
KYC is valid 24 months for individuals, 12 for entities. Expiry moves a wallet to RESTRICTED (sell/withdraw only). AML alerts at High severity may freeze a wallet — always with a case ticket and audit log.
NAV = Σ(component values) + cash + receivables − liabilities − accrued fees NAV/share = NAV ÷ tokens outstanding at cut-off
{{ nr.t }} — {{ nr.d }}

Proof of Reserves

Approved auditors and custodians sign reserve reports with registered keys. Each report is SHA-256 hashed and anchored on-chain with its cut-off timestamp.
≥ 100%
Badge RESERVES_VERIFIED on the public profile.
< 100%
Critical alert: mint locked, investors notified ≤ 24h, issuer must respond in 72h.
> 7 DAYS LATE
Public RESERVE_OVERDUE label and automatic risk-score penalty.

Risk scoring

A 0–100 score recomputed at least daily from five weighted components, published as an A–D band. Model weights are versioned; every change is audit-logged.
COMPONENT WEIGHTS
{{ rc.t }}
{{ rc.w }}
RATING BANDS
{{ bd.g }} {{ bd.r }}

API Reference

{{ ep.m }}
{{ ep.p }}
{{ ep.d }}

SDKs

{{ sd.lang }}
{{ sd.v }}
{{ sd.code }}

Rate limits

PLAN
REQUESTS / MIN
BURST
WEBHOOK ENDPOINTS
{{ lm.plan }}
{{ lm.rpm }}
{{ lm.burst }}
{{ lm.wh }}
Limits are per key. Responses include X-RateLimit-Remaining; exceeding returns 429 with a Retry-After header.

Errors

Errors use a consistent envelope with machine-readable codes and a request ID for support.
{ "error": { "code": "DENY_NOT_WHITELISTED", "message": "Destination wallet is not whitelisted for RWA-0142.", "request_id": "req_9f27ab" } }
{{ ec.s }} {{ ec.code }}

Webhooks

Signed events (HMAC-SHA256) delivered with at-least-once semantics and automatic retries over 24 hours.
{{ h.e }}
{{ h.d }}

Changelog

{{ ch.date }}
{{ ch.tag }}
{{ ch.t }}
{{ ch.d }}

Support

Developer support
Integration questions and API issues.
devs@buildledgerone.xyz
Status page
Live uptime for API, oracles and anchoring.
status.buildledgerone.xyz
Security
Responsible disclosure & bug bounty.
security@buildledgerone.xyz
ON THIS PAGE
Introduction Quickstart Authentication Environments The Trust Layer Asset lifecycle Transfer compliance NAV & oracles Proof of Reserves Risk scoring API Reference SDKs Rate limits Errors Webhooks Changelog Support