SOL… ETH… BTC… NEAR… XRP… LINK… AVAX… ONDO…
COIN… MSTR… HOOD… NVDA… QQQ… SPY… BLK… JPM… ICE…

Prices by CoinGecko. Stock quotes delayed, from Nasdaq public data. Not a Nasdaq partner.

Documentation · Preview

Sandbox API docs

Documentation for a preview institutional sandbox API. The sandbox API itself is not live on nodetrail.io. No keys are issued here. No prices.

Preview documentation only. This page describes a sandbox design that answers from saved fixture data and never reads a live chain. There is no sandbox endpoint, sign-in, or key desk on this site. Do not treat these paths as a live service.
Download OpenAPI spec (preview)

What the sandbox is

Authentication (draft)

If the sandbox were running, a key would be sent as a bearer token: Authorization: Bearer nt_test_... That flow is not available here.

Rate limits (preview draft values)

Specified endpoints (not live)

These paths are part of the preview specification. They are not served on nodetrail.io.

MethodPathWhat it would return
GET/api/inst/sandbox/v1/pingKey check
GET/api/inst/sandbox/v1/assetsThe fixture assets that can be checked
GET/api/inst/sandbox/v1/check?chain=&address=A fixture report with a content hash, sources, and what was not checked

Example requests (specification only)

These examples use a placeholder host. They will not work against nodetrail.io.

export NT_KEY="nt_test_..."   # a sandbox key, if one had been issued in a preview environment

curl -s https://example.invalid/api/inst/sandbox/v1/ping -H "Authorization: Bearer $NT_KEY"

curl -s https://example.invalid/api/inst/sandbox/v1/assets -H "Authorization: Bearer $NT_KEY"

curl -s "https://example.invalid/api/inst/sandbox/v1/check?chain=base&address=0x0000000000000000000000000000000000000000" -H "Authorization: Bearer $NT_KEY"

Errors (draft)

HTTPcodeMeaning
401bad_keyMissing, unknown or malformed key
401revokedThe key was revoked
401live_key_rejectedNot a sandbox key
404not_in_fixturesNo fixture for that chain and address
429rate_limitedSlow down; see Retry-After

Service targets (draft)

Targets only. Not an SLA. No uptime or latency is promised, and none is measured here. No prices.