Developer Documentation

BettorToken API.

A read-only data API exposing investor-specific NAV, position, and transaction data to verified partners. Designed for portfolio aggregation tools, family-office reporting platforms, and CPA/tax-prep integrations. Not a public API — credentials are issued on a per-relationship basis under NDA.

AVAILABLE TO VERIFIED PARTNERS UNDER NDA

Authentication

OAuth 2.0 with scoped credentials.

Partners receive a client_id and client_secret after partnership agreement execution. Investor-level access requires the investor to authorize the partner via OAuth flow within the BettorToken portal — read-only scopes only.

REQUEST · POST /oauth/token

cURL

curl -X POST https://api.bettortoken.com/v1/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_INVESTOR_FLOW" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

RESPONSE · 200 OK

JSON

{
  "access_token": "bt_at_a1b2c3d4e5f6...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "bt_rt_z9y8x7w6v5u4...",
  "scope": "investor.positions:read investor.transactions:read"
}

Endpoints

Read-only data access.

GET /v1/nav

Returns current and historical SPLT NAV. Updated daily at 09:00 ET. Historical range up to fiscal-year-1 inception (April 2025).

{
  "current_nav": 1.0352,
  "previous_nav": 1.0331,
  "currency": "USD",
  "as_of": "2026-04-24T09:00:00-04:00",
  "fiscal_year": 2,
  "fiscal_day": 23,
  "annual_differential_ytd": 0.0352
}

GET /v1/investor/positions

Returns the authenticated investor's current FYN and SPLT positions. Includes principal, accrued yield (FYN), current valuation (SPLT), and maturity dates.

{
  "investor_id": "inv_4f9a2c8b...",
  "positions": [
    {
      "instrument": "FYN",
      "principal_usd": 250000,
      "issue_date": "2025-09-15",
      "maturity_date": "2026-09-15",
      "coupon_rate": 0.15,
      "accrued_yield_usd": 22397.26
    },
    {
      "instrument": "SPLT",
      "tokens_held": 250000,
      "current_nav": 1.0352,
      "current_value_usd": 258800.00,
      "fiscal_year": 2,
      "next_reset_date": "2027-04-30"
    }
  ]
}

GET /v1/investor/transactions

Returns historical transactions: subscriptions, distributions, redemptions, NAV resets. Supports ?from=YYYY-MM-DD&to=YYYY-MM-DD query parameters.

{
  "transactions": [
    {
      "id": "tx_8e2d1a4f...",
      "type": "subscription",
      "instrument": "SPLT",
      "amount_usd": 250000,
      "tokens": 250000,
      "settled_at": "2025-09-15T13:42:08Z"
    },
    {
      "id": "tx_3c7b9e0a...",
      "type": "annual_reset",
      "instrument": "SPLT",
      "annual_differential": 0.7650,
      "reset_at": "2026-04-30T09:00:00-04:00"
    }
  ],
  "next_cursor": null
}

GET /v1/investor/tax-forms

Lists available tax forms (1099-INT for FYN, K-1 for SPLT participation entities). Returns metadata; document-level access requires investor-delegated permission to the partner application.

{
  "tax_forms": [
    {
      "tax_year": 2025,
      "form_type": "1099-INT",
      "instrument": "FYN",
      "issued_at": "2026-01-31",
      "download_url": "https://api.bettortoken.com/v1/secure/forms/..."
    }
  ]
}

Rate Limits

Reasonable, by design.

120 req/min per partner credential — read endpoints
10 req/min per partner credential — token issuance/refresh
429 response with Retry-After header on exceedance
Custom limits available for high-volume partners by request

Security

What you'd expect, plus what you wouldn't.

TLS 1.3 only — no fallback
Tokens scoped to investor-delegated permissions
No write endpoints in v1 — read-only by design
All access logged; investors can revoke partner authorization at any time from the portal
Annual third-party penetration testing

Partner Onboarding

Want API access?

Credentials are issued to verified partners — portfolio aggregators, family-office reporting platforms, CPA/tax-prep tools. Reach out and we'll walk through partnership requirements and the credential issuance process.

partners@bettortoken.com View Full Architecture