> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modo.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Metahub

<img src="https://mintcdn.com/modo/IRebiEa2wpGrfdyH/images/metagub-ai.jpg?fit=max&auto=format&n=IRebiEa2wpGrfdyH&q=85&s=13a58d82e94966905c0802d90ef7e100" alt="Metagub Ai" width="1100" height="367" data-path="images/metagub-ai.jpg" />

Modo aggregates valuable on- and off-chain data and manages it through **Metahub**, its comprehensive **name services.**

<Callout icon="star-shooting" color="#ff7800">
  Metahub connects blockchain records with verified context, making metadata more than just labelling but giving business data the structure it needs to be found, understood, and used well.
</Callout>

## The Metadata Challenge

Metadata is critical for making sense of blockchain data. But today, it’s poorly handled, inconsistent, and difficult to work with **–** creating real usability challenges.

<AccordionGroup>
  <Accordion title="Raw Data Without Readable Context">
    On-chain data is often raw, fragmented, pseudonymous, and hard to read. Without clear classification, users lose context, search gets harder, and discovery and interpretation slow down and become less effective.
  </Accordion>

  <Accordion title="Fragmented Identity">
    Metadata is usually scattered and hidden in a stream of on-chain data, making lookups slower, integration harder, and errors become much more likely.
  </Accordion>

  <Accordion title="Opaque Labeling and Risk">
    Label attribution rules remain a black box for users, who need to understand how a label was assigned, what signals support it, and whether the attribution can be verified.
  </Accordion>
</AccordionGroup>

<Check>
  To address these gaps, Metahub turns them into usable metadata for search, analysis, verification, and product workflows.
</Check>

## Turning Labels Into Intelligence

Most explorers stop at attaching names to blockchain records. The next layer begins when labeled entities can interact with each other as structured data.

<Callout icon="lightbulb-exclamation-on" color="#ff8900">
  The same labels used for navigation can also power analytics, relationship mapping, flow tracking, and financial audits.
</Callout>

Labels stop being simple tags and become part of a living intelligence layer built on top of blockchain activity. Metahub builds a wider business context around abstracted on-chain data.

## High-Quality Labeling in Practice

Metahub uses labels to make technical blockchain records easier to interpret without hiding the underlying data.

<Tabs>
  <Tab title="Profile">
    In the [Modo CC Public](https://cc.modo.link/mainnet/party/Digital-Asset-1::12203a616cd41a519d1950ffd4df0ced808cce3bea558d684296c007bb8e12d7f649) example, ecosystem records for an account are consolidated into a structured profile that includes domains, links, status labels, apps, tokens, and related entities.

    <img src="https://mintcdn.com/modo/IRebiEa2wpGrfdyH/images/new-party-screen-1.png?fit=max&auto=format&n=IRebiEa2wpGrfdyH&q=85&s=9e6e8dc293edc3c76f6ae60f55a80811" alt="New Party Screen" width="1668" height="943" data-path="images/new-party-screen-1.png" />
  </Tab>

  <Tab title="Performance">
    Activity with related [parties](https://cc.modo.link/mainnet/party/kora-app::1220efef3108b73891ecb7992fadf48bf7bd99e93ad071ec95da7cc40a53a8ebe8bf/analytics/rewards?cumulative_parties=AlfieL%3A%3A122018daa26c2b2cb29cbfe6f5445f62eed78f113b0a1973126d009b3bc8fa56ec14,Allian-Palm%3A%3A122057bd61fb20cff8ca9055f96748006ebf42721e4ebd0e04cddedce366a938a359,AlphaQuote%3A%3A1220490a741708b347f21667bf3c8d38af7a0fa66c11c3f626c34563051238db7b42) can be grouped in a shared analytics view that shows combined rewards, PnL, and performance metrics across different time ranges, enabling account audit.

    <img src="https://mintcdn.com/modo/5s8H5rqnaPSpsPpY/images/2026-05-21_20-33-05.png?fit=max&auto=format&n=5s8H5rqnaPSpsPpY&q=85&s=a8e1a95b108b27482c85617b2e3adbef" alt="2026 05 21 20 33 05" className="mx-auto" style={{ width:"88%" }} width="1700" height="777" data-path="images/2026-05-21_20-33-05.png" />
  </Tab>

  <Tab title="Activity">
    Here, in [Suiscan](https://suiscan.xyz/mainnet/tx/Hmi5hAodtHuDaiV6CRMqpL9dvPyTBfPzyj8inNxdeus8), labels make transaction flows easier to read by combining actions, header icons, token icons, package labels, and protocol context into a single structured view.

    <Frame>
      <img src="https://mintcdn.com/modo/5s8H5rqnaPSpsPpY/images/activity.png?fit=max&auto=format&n=5s8H5rqnaPSpsPpY&q=85&s=99226a97762e09502b2ef9e10cbd8d21" alt="Activity" className="mx-auto" style={{ width:"76%" }} width="1130" height="603" data-path="images/activity.png" />
    </Frame>
  </Tab>

  <Tab title="Contracts">
    Instead of scanning only raw package IDs and Move calls, users can quickly identify which contract, module, or function is involved in the execution flow, while keeping the underlying technical data available for verification.

    <Frame>
      <img src="https://mintcdn.com/modo/IRebiEa2wpGrfdyH/images/image-83.png?fit=max&auto=format&n=IRebiEa2wpGrfdyH&q=85&s=4e67880fe8a2e2be142a8a9a76f9ee65" alt="Image" title="Image" className="mx-auto" style={{ width:"82%" }} width="1006" height="665" data-path="images/image-83.png" />
    </Frame>
  </Tab>

  <Tab title="Pools">
    Pool labels make object data easier to understand by showing the trading pair and the underlying protocol.

    <img src="https://mintcdn.com/modo/IRebiEa2wpGrfdyH/images/pools.png?fit=max&auto=format&n=IRebiEa2wpGrfdyH&q=85&s=57bbd7cc724e9c01e8685a0aa692b174" alt="Pools" className="mx-auto" width="1108" height="181" data-path="images/pools.png" />
  </Tab>

  <Tab title="Coins">
    Coin labels make portfolio data easier to read by turning raw coin types into recognizable assets with names, icons, verification status, and market data.

    <Warning>
      Labeling is especially critical for coins: on Sui, anyone can issue a token with the ticker, and without verification, users won't be able to distinguish official tokens from counterfeits.
    </Warning>

    <img src="https://mintcdn.com/modo/5s8H5rqnaPSpsPpY/images/coins.png?fit=max&auto=format&n=5s8H5rqnaPSpsPpY&q=85&s=b3835c19dff760f2537cbee74ce50f67" alt="Coins" className="mx-auto" width="1678" height="492" data-path="images/coins.png" />
  </Tab>

  <Tab title="NFTs">
    Instead of showing only object IDs or type strings, the interface displays assets with clearer context, such as NFT name, visual preview, category, and related collection.

    <img src="https://mintcdn.com/modo/IRebiEa2wpGrfdyH/images/nft.png?fit=max&auto=format&n=IRebiEa2wpGrfdyH&q=85&s=de7db698b09e91a92b403a0641a6f90a" alt="Nft" width="1672" height="405" data-path="images/nft.png" />
  </Tab>

  <Tab title="Actions">
    Action labels make transaction lists easier to scan by showing the transaction type together with the main action or function name, such as `open_position_with_liquidity_by_fix_coin` or `into_balance`.

    <img src="https://mintcdn.com/modo/5s8H5rqnaPSpsPpY/images/actions.png?fit=max&auto=format&n=5s8H5rqnaPSpsPpY&q=85&s=51b81a39de62994f3f61edc7cbb82e28" alt="Actions" className="mx-auto" style={{ width:"83%" }} width="1184" height="607" data-path="images/actions.png" />
  </Tab>

  <Tab title="Malicious">
    Malicious labels identify entities flagged for suspicious or harmful behavior. These labels can be applied to accounts, packages, pools, NFTs, coins, or projects when there are clear signals, such as scam reports, a history of rug pulls, or other verified malicious activity.

    <Warning>
      Each malicious case is reviewed individually, with a clear conclusion provided based on the available evidence and reporting context.
    </Warning>

    <img src="https://mintcdn.com/modo/IRebiEa2wpGrfdyH/images/mal-detection.png?fit=max&auto=format&n=IRebiEa2wpGrfdyH&q=85&s=da478d86effaade53ab429bff124c06c" alt="Mal Detection" width="1696" height="457" data-path="images/mal-detection.png" />
  </Tab>
</Tabs>

## Off-Chain Data Integration

Significant, valuable real-life information is often left outside the blockchain.

Below are samples of data we handle.

| **Data type** | **Data Objects**                                                                                 | **Data**                                                                                                                                                                                                                                                                                           |
| :------------ | :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Business data | - companies<br />- institutions<br />- staking and validation providers<br />- service providers | - name<br />- description<br />- category<br />- contacts<br />- website<br />- social links: Discord, Telegram, <br />X (Twitter)<br />- code repository<br />- related partners<br />- related projects and apps<br />- related tokens<br />- related contracts<br />- related service providers |
| Market Data   | - companies<br />- institutions<br />- staking and validation providers<br />- service providers | - price<br />- market cap<br />- trading volume<br />- circulated supply<br />- total supply                                                                                                                                                                                                       |
| Contract Data | smart contracts                                                                                  | - creator<br />- verification status<br />- source code<br />- related contracts<br />- related tokens                                                                                                                                                                                             |
| Token Metrics | tokens                                                                                           | - price<br />- market cap<br />- trading volume<br />- circulated supply<br />- total supply                                                                                                                                                                                                       |
| Project data  | - projects<br />- apps                                                                           | - company<br />- website<br />- category<br />- social links: Discord, Telegram, <br />X (Twitter)                                                                                                                                                                                                 |

# How Data Appears in Metahub

Modo uses **gRPC**, **human expertise**, and **AI automation** to populate Metahub with data.

<Columns cols={2}>
  <Column>
    <Card title="gRPC" icon="circle-nodes">
      Modo has direct access to on-chain data via gRPC nodes and makes it publicly available on explorers.
    </Card>
  </Column>

  <Column>
    <Card title="Experts" icon="head-side-gear">
      Our data scientists analyze sources, verify entities, and review the broader off-chain context first-hand.
    </Card>
  </Column>

  <Column>
    <Card title="Modo AI" icon="computer">
      AI scans raw data, extracts metadata, links entities, and speeds up classification.
    </Card>
  </Column>
</Columns>

# Use Cases

Below are specific use cases that demonstrate how Metahub makes a difference.

<Columns cols={2}>
  <Column>
    <Card title="Token Metrics" icon="coin">
      Token, Liquidity Pool, DEX Pair metadata like price, volume, \
      market cap, parameters.
    </Card>
  </Column>

  <Column>
    <Card title="Business Profile" icon="magnifying-glass-chart">
      Public accounts: company label, social links, related partners, projects, apps, \
      validators, infrastructure, social links.
    </Card>
  </Column>

  <Column>
    <Card title="Directory" icon="square-list">
      Full list and summary of companies, projects, and applications found in a blockchain ecosystem.
    </Card>
  </Column>

  <Column>
    <Card title="Domain Name Services" icon="ornament">
      Human-readable account names provided by Blockchain Domain Name Service systems.
    </Card>
  </Column>

  <Column>
    <Card title="Smart Contracts" icon="file-contract">
      Contract verification statuses, source code, related contracts, update history, and more.
    </Card>
  </Column>

  <Column>
    <Card title="Malicious Activity Detection" icon="bolt-lightning">
      Get alerts on accounts, tokens, smart contracts, and other objects showing suspicious activity.
    </Card>
  </Column>
</Columns>

This list is not exhaustive. As Modo evolves, more use cases will be available to you.

Companies are a critical source of information for Metahub. If you want to be noticed, submit data to make yourself visible on-chain.

# Submit to Metahub!

<CardGroup cols={2}>
  <Card title="Data Submission" href="/platform/data-submission">
    Learn how to submit data in the Metahub.
  </Card>
</CardGroup>