Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.turtle.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Lumon is Turtle’s on-chain data infrastructure. It indexes ERC20 transfer events across all supported chains, builds balance timeseries, and provides the data substrate for deposit attribution, portfolio views, and revenue computation. Two capabilities are exposed to partners:
  1. Deposit attribution — every deposit routed through the Earn API carries an embedded tracking signature in the transaction calldata. Lumon detects these signatures on-chain, providing a cryptographic link between a deposit and the partner that sourced it — without any manual reporting.
  2. Token data — the Token Indexing API exposes real-time ERC20 portfolio balances, per-token holder data, historical snapshots, and token metadata across all indexed chains.

​
Attribution at a Glance

1

Partner requests deposit

Your integration calls POST /v1/actions/deposit with a distributorId. Turtle returns transactions with the tracking signature embedded in calldata.
2

User submits on-chain

The user (or your signing service) signs and submits the transactions. The tracking signature becomes part of the permanent on-chain record.
3

Lumon detects attribution

The Lumon collector monitors all supported chains for Turtle tracking signatures. When detected, the deposit is recorded with verified status.
4

Data available via API

The attributed deposit appears in your distributor activity feed and is verifiable via the verify endpoint.
For a detailed walkthrough, see How Attribution Works.

​
Token Data at a Glance

The Token Indexing API at indexing.turtle.xyz/token provides:
  • Portfolio queries — all current ERC20 balances for any indexed wallet address
  • Balance lookups — specific token balance for a user on a given chain
  • Top holders — largest holders of any indexed token (up to 100)
  • Token metadata — name, symbol, decimals, transfer count, total supply
  • Historical snapshots — point-in-time balance data and volume metrics
All endpoints are documented with an OpenAPI spec. See Token Indexing API for the full reference.

​
Why It Matters

For partners and integrators, Lumon provides transparent proof of deposit provenance. Your DD team can independently verify that any deposit was sourced by your integration — using the public verify endpoint or by inspecting the raw calldata on a block explorer. For reconciliation, Lumon feeds a settlement pipeline that powers distributor activity feeds, volume tracking, and revenue attribution. Every attributed deposit is queryable within minutes of on-chain confirmation. For data consumers, the Token Indexing API provides balance and portfolio data without running your own indexer — the same data layer that powers Turtle’s internal portfolio views and commission calculations.

​
Lumon Section

How Attribution Works

The four-step attribution flow from deposit request through on-chain detection.

Tracking Signature

Format, extraction, and on-chain proof of the tracking signature embedded in calldata.

Token Indexing API

ERC20 portfolio, balance, holder, and snapshot endpoints.

Independent Verification

How to verify deposit attribution for audits, reconciliation, and due diligence.

Data Flow & Settlement

The settlement pipeline from on-chain detection to queryable records.