Getting Started
Token Analytics enables seamless tracking and management of crypto tokens across various networks, providing businesses and investors with a full suite of features to stay informed and in control of their tokenized assets.
- Token Management. Easily add, update, or remove tokens for tracking on specific blockchain networks.
- Transaction Tracking. Follow token transactions in real time to monitor value movements.
- Historical Transaction Import. Import historical token transaction data to get a complete overview of past activities.
- Capitalization Table Review. Access a detailed breakdown of current and historical token holders, with corresponding token amounts, to understand ownership distribution at any point in time.
- Token Price History. Review price history across different time frames.
- Capitalization History. Analyze token capitalization history to gauge the evolution of a token's market performance over time.
- Token Name: This is a discretionary name of the token. This name will be included in the response to GET v1/tokens as well as other token endpoints where token details are required.
Helpful Terminology
| Term | Meaning |
| Token | A digitized asset allowing information and value to be transferred, stored, and verified in an efficient & secure manner. |
| Token ID | The token’s address on a specific ledger. This may have a slightly different format for EVM vs. other non-EVM ledgers. |
| Tracking Status | Indicates whether a token or wallet is enabled or disabled for aggregating ledger transactions. |
| External ID | A LedgerScan specific attribute of a token or wallet which is user defined at the point of configuring the object. This may be used for establishing a common identifier (account, or asset identifier) of a wallet or token which is represented in a new or existing financial system that has been integrated with LedgerScan. |
| Priced As | When specifying pricing for a token, the Priced As is the base asset symbol that is being priced. For BTC/USD – BTC is the priced asset. |
| Priced In |
When specifying pricing for a token, the Priced In is the asset used to express price. For BTC/USD – USD is the priced in asset. In the initial release of LedgerScan, Priced In will default to USD. |
| Cap Table | The master shareholder registry which shows all wallets holding a specified asset, their % ownership of the asset, quantity of tokens held, and value of tokens held. |
| Transactions | A ledger transaction can represent any state change, transfer of value, or any other change which occurs on the blockchain. |
| Activities | An activity is a transaction from the perspective of the Wallet or Token of interest. |
| Ledger | A ledger is a reference to a specific blockchain network. Examples include Ethereum Mainnet, Polygon, Avalanche, HyperLedger Besu, Stellar, etc. |
Tracking Tokens
Tracking a token of interest is quick and easy and results in LedgerScan aggregating data from the ledger 24x7 until token tracking is disabled. To aggregate data for a token of interest, follow the steps in the table below.
| Step | Endpoint | Description |
|
1 |
GET /v1/networks/ledgers |
Retrieves the list of supported ledgers within the tenancy. This endpoint may be optionally used in advance of adding a token or wallet as a ledger must be specified for both. |
|
2 |
POST v1/tokens |
Adds the token to the LedgerScan database. The token will default to a disabled tracking status. See API Reference for detailed parameters. |
|
3 |
PUT v1/tokens/{tokenId}/tracking |
Enables tracking status causing data aggregation on the token to begin. This same endpoint may be used for disabling tracking as well. |
|
4 |
GET v1/tokens |
Optional: Retrieves a list of all tokens and the associated token summary data. See API Reference for detailed parameters. |
Adding a token will involve providing the following attributes of the token:
- Ledger: The ledger on which the token has been issued.
- Symbol: Symbol of the token.
- Ledger ID: The address of the token’s smart contract.
- External ID: Discretionary field that you can use to insert any ID to correlate this token with externally integrated systems.
The point at which token data is aggregated from the ledger is the point when tracking is enabled. No historical data prior to the point of tracking will be automatically collected. However, historical ledger data can be requested (coming soon).
Caution: When a user toggles a token from enabled to disabled, data aggregation will stop. At some point in the future, if the tracking status of the token is enabled again, data aggregation will resume. However, this will create a gap in your data. Filling this gap will require requesting historical data for the token during the period of the gap. Ensure only authorized administrators have permissions to toggle tracking status.
Once the sequence of steps are complete you may begin calling other token endpoints to view data such as token activities and cap tables. Note however, the data will only show the quantity of tokens associated with activities and cap tables. To enrich with pricing and value, see the pricing administration guide.
Retrieving Token Data
Once a token has been added and enabled for tracking, retrieving views of the token data are enabled. The entries in the table below can be independently called to retrieve a token’s detailed attributes, activities, cap table, market capitalization history, and/or token price history:
| Step | Endpoint | Description |
|
1 |
GET v1/tokens | Retrieves a list of all tokens currently being tracked and the associated token summary data. |
|
2 |
GET v1/tokens/{tokenId} | Retrieves detailed information about a specific token such as name, symbol, ledger, tracking status, etc. |
|
3 |
GET /v2/pairs/{pairId}/prices/history |
Retrieves the token’s price history. This requires the token to be linked to a pricing pair. |
|
4 |
GET v1/tokens/{tokenId}/activities |
Retrieves a paginated set of token activities showing type, date, status, from/to wallets, amount and value. Activity value is only available when token is linked to a pricing pair. |
|
5 |
GET v1/tokens/{tokenId}/cap-table |
Returns the cap table for the token. If the token is linked to a pricing pair, value will be represented against each of the token holder’s positions. |
|
6 |
GET v1/tokens/{tokenId}/market-capitalization |
Retrieves the current and historical capitalization table for a token. This requires the token to be linked to a pricing pair. |
As noted, if pricing and value calculations are desired, the token must be linked to a pricing pair. See the Pricing Administration Guides for more information.