The Mobula API provides a powerful GraphQL endpoint that allows you to query and explore data for various tokens. This guide will show you how to retrieve the token contracts with the highest 24-hour trading volume per blockchain using GraphQL.

​
What you’ll need

  1. Access to the Mobula GraphQL endpoint.
  2. No API key is required for development purposes.

​
Walkthrough

1

Set Up Your Query Parameters

You will be querying the tokens table, filtering the results by blockchain, and sorting them by 24-hour trading volume in descending order. We will use distinct_on to get the top token by trading volume for each blockchain.

2

Apply Filters

To ensure you’re retrieving the tokens with the most trading activity, you can apply additional filters for 24-hour volume and blockchain. This will help refine your search to ensure you’re getting the most relevant tokens on each chain.

Filters:

  • 24-Hour Volume (volume_24h_usd): You may filter tokens to only include those with significant trading activity over the last 24 hours.
  • Blockchain (chain_id): Separate tokens by blockchain to ensure you’re getting the top volume token on each chain.

Example filters:

  • Sort by 24-hour volume in descending order: order_by: { volume_24h_usd: desc }
  • Limit the results to the top token on each blockchain with distinct_on: chain_id.
3

Perform the GraphQL Request

Execute the GraphQL query using cURL, Axios, or any GraphQL client:

Using cURL:

curl -X POST https://gql.mobula.io/v1/graphql \
-H "Content-Type: application/json" \
--data '{
  "query": "query TopTokensByVolume { tokens(order_by: { chain_id: asc, volume_24h_usd: desc }, distinct_on: chain_id) { asset_id name symbol address volume_24h_usd chain_id } }"
}'

Using Axios:

import axios from "axios";

const query = `
  query TopTokensByVolume {
    tokens(order_by: { chain_id: asc, volume_24h_usd: desc }, distinct_on: chain_id) {
      asset_id
      name
      symbol
      address
      volume_24h_usd
      chain_id
    }
  }
`;

axios.post('https://gql.mobula.io/v1/graphql', {
  query: query
}, {
  headers: {
    'Content-Type': 'application/json'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Using a GraphQL Client (e.g., Apollo Client):

import { gql, ApolloClient, InMemoryCache } from '@apollo/client';

const client = new ApolloClient({
  uri: 'https://gql.mobula.io/v1/graphql',
  cache: new InMemoryCache()
});

const GET_TOP_TOKENS_BY_VOLUME = gql`
  query TopTokensByVolume {
    tokens(order_by: { chain_id: asc, volume_24h_usd: desc }, distinct_on: chain_id) {
      asset_id
      name
      symbol
      address
      volume_24h_usd
      chain_id
    }
  }
`;

client.query({ query: GET_TOP_TOKENS_BY_VOLUME })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));
4

Analyze the Token Data

The API response will include detailed information about each token, such as their name, symbol, contract address, 24-hour trading volume in USD, and the blockchain they are on.

Sample Response:

{
"data": {
  "tokens": [
    {
      "asset_id": 100000587,
      "name": "Alephium",
      "symbol": "ALPH",
      "address": "tgx7VNFoP9DJiFMFgXXtafQZkUvyEdDHT9ryamHJYrjq",
      "volume_24h_usd": 256052,
      "chain_id": "alephium:0"
    },
    {
      "asset_id": 100011613,
      "name": "Tether USD",
      "symbol": "USDT",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "volume_24h_usd": 509014379,
      "chain_id": "evm:1"
    },
      // More tokens...
    ]
  }
}

​
Leveraging Token Data

With this data, you can:

  • Display Top Tokens by Chain: Show the tokens with the highest 24-hour trading volume on each blockchain in your app or dashboard.
  • Track Market Performance: Monitor the market trends of top tokens by observing changes in trading volume.
  • Build Blockchain-Specific Leaderboards: Create ranked lists of tokens based on trading volume for different blockchains.

​
Need Help?

Our support team is available to assist with your queries or integration issues.

Support

Telegram

Support

Slack

Support

Discord

Email Support

Email

GraphQL Query Top 100 Assets