GET: 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: /agents

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. Values base
agent_tickers	string	Yes	Comma-separated Loky agent tickers to query information for
agent_addresses	string	No	Comma-separated agent contract addresses to fetch info
agent_ids	string	No	Comma-separated Loky agent IDs to retrieve data for
ecosystem	string	No	Ecosystem to query agents from; currently supports virtuals

Sample cURL Request:

# With Agent Tickers
curl -X GET "https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&agent_tickers=AIXBT" -H "Content-Type: application/json"

# With Agent Addresses
curl -X GET "https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&agent_addresses=0xec31cb55d79c750510b2e075d0832d23810f8c44" -H "Content-Type: application/json"

# With Agent IDs
curl -X GET "https://api.dapplooker.com/v1/agents?api_key=<API_KEY>&chain=base&agent_ids=aixbt" -H "Content-Type: application/json"

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.1263900000",
                "resistance": "0.1638100000",
                "rsi": "33.17",
                "sma": "0.1414580000"
            },
            "agent_holder_insights": {
                "total_holder_count": 324861,
                "holder_count_change_percentage_24h": "0.06",
                "fifty_percentage_holding_wallet_count": "21.00",
                "first_100_buyers_initial_bought": "945882.24",
                "first_100_buyers_initial_bought_percentage": "0.09",
                "first_100_buyers_current_holding": "2030284.25",
                "first_100_buyers_current_holding_percentage": "0.20",
                "top_10_holder_balance": "392702219.07",
                "top_10_holder_percentage": "39.27",
                "top_50_holder_balance": "608039886.38",
                "top_50_holder_percentage": "60.80",
                "top_100_holder_balance": "662691392.53",
                "top_100_holder_percentage": "66.27"
            },
            "smart_money_insights": {
                "top_25_holder_buy_24h": "26799549.90",
                "top_25_holder_sold_24h": "8895784.60"
            },
            "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": "0.00"
            },
            "agent_metrics": {
                "usd_price": "0.1882",
                "mcap": "174133778.00",
                "fdv": "188183166.00",
                "volume_24h": "89494219.00",
                "total_liquidity": "2217785.10",
                "price_change_percentage_1h": "-0.06",
                "price_change_percentage_24h": "9.95",
                "price_change_percentage_7d": "-9.49",
                "price_change_percentage_30d": "125.85",
                "volume_change_percentage_7d": "-46.30",
                "volume_change_percentage_30d": "168.80",
                "mcap_change_percentage_7d": "-15.80",
                "mcap_change_percentage_30d": "144.50",
                "price_high_24h": "0.1978",
                "price_ath": "0.9426",
                "circulating_supply": "925341953.00",
                "total_supply": "1000000000.00"
            },
            "x_social_metrics": {
                "mindshare_3d": 3.7342412746063958,
                "mindshare_change_percentage_3d": -9.43,
                "impression_count_3d": 2129876,
                "impression_count_change_percentage_3d": 21.62,
                "engagement_count_3d": 33170,
                "engagement_count_change_percentage_3d": 12.39,
                "follower_count_3d": 459015,
                "smart_follower_count_3d": 7362,
                "mindshare_7d": 3.8409215448023053,
                "mindshare_change_percentage_7d": -11.27,
                "impression_count_7d": 4737816,
                "impression_count_change_percentage_7d": 3.17,
                "engagement_count_7d": 76813,
                "engagement_count_change_percentage_7d": -7.94,
                "follower_count_7d": 459015,
                "smart_follower_count_7d": 7329
            },
            "last_updated_at": "2025-05-20T08:45:09.740Z"
        }
    ]
}

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.