Agent Details

Retrieve detailed information and comprehensive metrics for specified agent(s). This endpoint is critical for in-depth analysis, including market data, technical indicators, and “smart money” insights

Endpoint

GET https://api.dapplooker.com/v1/agents

💡 Pro Tips

  • This endpoint returns a maximum of 30 items per page. Use page query parameter and pagination attributes (being returned in the response) to navigate through results.

  • You can fetch agents data directly by specifying the chain and ecosystem—no need to pass individual agent addresses, ids or tickers.

  • To retrieve data for specific agent(s), use the agent_addresses , agent_ids or agent_tickers query parameter.

Query Parameters

Parameter name

Type

Mandatory

Description

api_key

string

Yes

Your unique Loky API key used for authentication

chain

string

Yes

The network chain to query. Supported chains: base

agent_tickers

string

Yes

Comma-separated Loky agent tickers (upto 30) to fetch info

agent_addresses

string

No

Comma-separated agent contract addresses (upto 30) to fetch info

agent_ids

string

No

Comma-separated Loky agent IDs (upto 30) to fetch info

ecosystem

string

No

Specific ecosystem tokens to query. Supported ecosystem: virtuals

page

string

No, Default page 1

Page number, 30 items per page

Sample Request

# With Agent Tickers
curl --location 'https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&agent_tickers=AIXBT'

# With Agent Addresses
curl --location 'https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&agent_addresses=0xec31cb55d79c750510b2e075d0832d23810f8c44'

# With Agent IDs
curl --location 'https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&agent_ids=aixbt'

# With Pagination Enabled Ecosystem Filter
curl --location 'https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&ecosystem=virtuals&page=1'

Sample Response

{
  "success": true,
  "data": [
    {
      "id": "aixbt",
      "rug_status": "SAFE",
      "agent_info": {
        "id": "aixbt",
        "symbol": "AIXBT",
        "name": "aixbt by Virtuals",
        "handle": "aixbt_agent",
        "description": "AIXBT is an AI agent and driven crypto market intelligence platform designed to provide token holders with a strategic edge in the rapidly evolving crypto space. Leveraging advanced narrative detection and alpha-focused analysis, AIXBT automates the process of tracking and interpreting market trends, helping users gain actionable insights. This project emphasizes integrating various data sources and platforms for comprehensive analysis and decision-making.",
        "ca": "0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825",
        "chain": "base",
        "ecosystem": "virtuals"
      },
      "technical_indicators": {
        "support": "0.2033100000",
        "resistance": "0.2459300000",
        "rsi": "37.59",
        "sma": "0.2277222000"
      },
      "agent_holder_insights": {
        "total_holder_count": 322411,
        "holder_count_change_percentage_24h": "0.07",
        "fifty_percentage_holding_wallet_count": "19.00",
        "first_100_buyers_initial_bought": "945882.24",
        "first_100_buyers_initial_bought_percentage": "0.09",
        "first_100_buyers_current_holding": "2029694.15",
        "first_100_buyers_current_holding_percentage": "0.20",
        "top_10_holder_balance": "404103553.32",
        "top_10_holder_percentage": "40.41",
        "top_50_holder_balance": "618839404.94",
        "top_50_holder_percentage": "61.88",
        "top_100_holder_balance": "669458771.16",
        "top_100_holder_percentage": "66.95"
      },
      "smart_money_insights": {
        "top_25_holder_buy_24h": "4974204.10",
        "top_25_holder_sold_24h": "6104555.30"
      },
      "dev_wallet_insights": {
        "wallet_address": "0x8dfb37aae4f8fcbd1f90015a9e75b48f50fd9f59",
        "wallet_balance": null,
        "dev_wallet_total_holding_percentage": null,
        "dev_wallet_outflow_txs_count_24h": null,
        "dev_wallet_outflow_amount_24h": null,
        "fresh_wallet": false,
        "dev_sold": false,
        "dev_sold_percentage": "0.00",
        "bundle_wallet_count": 1,
        "bundle_wallet_supply_percentage": null
      },
      "agent_metrics": {
        "usd_price": "0.2069",
        "mcap": "193096788.00",
        "fdv": "206577641.00",
        "volume_24h": "98498933.00",
        "total_liquidity": "3040595.90",
        "price_change_percentage_1h": "1.61",
        "price_change_percentage_24h": "-10.30",
        "price_change_percentage_7d": "-0.90",
        "price_change_percentage_30d": "30.93",
        "volume_change_percentage_7d": "-6.90",
        "volume_change_percentage_30d": "22.20",
        "mcap_change_percentage_7d": "9.50",
        "mcap_change_percentage_30d": "43.00",
        "price_high_24h": "0.2316",
        "price_ath": "0.9426",
        "circulating_supply": "934741953.00",
        "total_supply": "1000000000.00"
      },
      "x_social_metrics": {
        "mindshare_3d": 3.89078276679337,
        "mindshare_change_percentage_3d": -8.96,
        "impression_count_3d": 1993494,
        "impression_count_change_percentage_3d": -1.31,
        "engagement_count_3d": 32860,
        "engagement_count_change_percentage_3d": 0.59,
        "follower_count_3d": 458966,
        "smart_follower_count_3d": 7363,
        "mindshare_7d": 4.14033463609196,
        "mindshare_change_percentage_7d": -0.02,
        "impression_count_7d": 4740567,
        "impression_count_change_percentage_7d": 2.09,
        "engagement_count_7d": 78922,
        "engagement_count_change_percentage_7d": -3.13,
        "follower_count_7d": 458966,
        "smart_follower_count_7d": 7343
      },
      "last_updated_at": "2025-05-30T11:18:41.580Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 30,
      "pageCount": 1,
      "total": 1
    }
  }
}

Response Fields Explanation

Agent Info:

  • id (string): Unique identifier for the token.

  • symbol (string): Token symbol.

  • name (string): Token name.

  • handle (string): Token X(twitter) handle.

  • image (string): URL of the token’s image.

  • description (string): Description of the token.

  • ca (string): Contract address of the token.

  • chain (string): The network chain.

  • ecosystem (string): Ecosystem of the token.

Technical Indicators:

  • support (decimal): Support price level.

  • resistance (decimal): Resistance price level.

  • rsi (decimal): Relative Strength Index (RSI) of the token.

  • sma (decimal): Simple Moving Average (SMA) of the token

Agent Holder Insights:

  • total_holder_count (integer): Total number of agent holders.

  • holder_count_change_percentage_24h (decimal): Change in the number of holders over the last 24 hours (percentage).

  • fifty_percentage_holding_wallet_count (integer): Number of wallets holding 50% of the total supply.

  • first_100_buyers_initial_bought (decimal): Total amount initially purchased by the first 100 buyers.

  • first_100_buyers_initial_bought_percentage (decimal): Percentage of total supply initially bought by the first 100 buyers.

  • first_100_buyers_current_holding (decimal): Current total holdings of the first 100 buyers.

  • first_100_buyers_current_holding_percentage (decimal): Current percentage of total supply held by the first 100 buyers.

  • top_10_holder_balance (decimal): Combined token balance of the top 10 holders.

  • top_10_holder_percentage (decimal): Percentage of total token supply held by the top 10 holders.

  • top_50_holder_balance (decimal): Combined token balance of the top 50 holders.

  • top_50_holder_percentage (decimal): Percentage of total token supply held by the top 50 holders.

  • top_100_holder_balance (decimal): Combined token balance of the top 100 holders.

  • top_100_holder_percentage (decimal): Percentage of total token supply held by the top 100 holders.

Smart Money Insights:

  • top_25_holder_buy_24h (decimal): Amount of agents bought by the top 25 holders in the last 24 hours.

  • top_25_holder_sold_24h (decimal): Amount of agents sold by the top 25 holders in the last 24 hours.

Agent Metrics:

  • usd_price (decimal): Current price of the token in USD.

  • mcap (decimal): Market capitalization of the token.

  • fdv (decimal): Fully diluted valuation of the token.

  • volume_24h (decimal): Trading volume of the token in the last 24 hours.

  • total_liquidity (decimal): Total liquidity of the agent in USD.

  • price_change_percentage_1h (decimal): Price change in the last 1 hour (percentage).

  • price_change_percentage_24h (decimal): Price change in the last 24 hours (percentage).

  • price_change_percentage_7d (decimal): Price change in the last 7 days (percentage).

  • price_change_percentage_30d (decimal): Price change in the last 30 days (percentage).

  • volume_change_percentage_7d (decimal): 7-day trading volume change (percentage).

  • volume_change_percentage_30d (decimal): 30-day trading volume change (percentage).

  • mcap_change_percentage_7d (decimal): 7-day market capitalization change (percentage).

  • mcap_change_percentage_30d (decimal): 30-day market capitalization change (percentage).

  • price_high_24h (decimal): Highest price of the token in the last 24 hours.

  • price_ath (decimal): All-time high price of the token.

  • circulating_supply (decimal): Number of tokens currently in circulation.

  • total_supply (decimal): Total supply of the token.

X Social Metrics:

  • mindshare_3d (decimal): Token's share of attention in social discussions in the past 3 days.

  • mindshare_change_percentage_3d (decimal): Percent change of mindshare value in the past 3 days.

  • impression_count_3d (integer): Number of times the token content is viewed in the past 3 days.

  • impression_count_change_percentage_3d (decimal): Percent change of impression count value in the past 3 days.

  • engagement_count_3d (integer): Interactions like likes, shares, and comments in the past 3 days.

  • engagement_count_change_percentage_3d (decimal): Percent change of engagement count value in the past 3 days.

  • follower_count_3d (integer): Total followers tracking the token in the past 3 days.

  • smart_follower_count_3d (integer): Followers with high influence or expertise in the past 3 days.

  • mindshare_7d (decimal): Token's share of attention in social discussions in the past 7 days.

  • mindshare_change_percentage_7d (decimal): Percent change of mindshare value in the past 7 days.

  • impression_count_7d (integer): Number of times the token content is viewed in the past 7 days.

  • impression_count_change_percentage_7d (decimal): Percent change of impression count value in the past 7 days.

  • engagement_count_7d (integer): Interactions like likes, shares, and comments in the past 7 days.

  • engagement_count_change_percentage_7d (decimal): Percent change of engagement count value in the past 7 days.

  • follower_count_7d (integer): Total followers tracking the token in the past 7 days.

  • smart_follower_count_7d (integer): Followers with high influence or expertise in the past 7 days.

Other Fields:

  • rug_status (string): Risk classification of the token or project based on on-chain and behavioral analysis. Possible values include:

    • 🟢 SAFE : No significant red flags detected; project appears legitimate.

    • 🟡 CAUTION : Some potential concerns exist; further investigation recommended.

    • 🟠 HIGH_RISK : High number of warning signs detected; exercise extreme caution.

    • 🔴 RUGGED : Project has been identified as a confirmed or highly probable rug pull.

  • last_updated_at (DateTime): UTC Time of last data update.

Pagination Attributes:

  • page (integer): The current given page number, also being returned in the response.

  • pageSize (integer): The number of max items can be included per page.

  • pageCount (integer): The total number of pages available.

  • total (integer): The total number of items available across all pages.

PreviousAI-Powered Query via NLQNextBest Practices

Last updated

Was this helpful?