DappLooker Docs
  • 👋Welcome
  • Data APIs for AI
    • Overview
    • Changelog
    • API Authentication
    • API Endpoints
      • GET: Crypto Token Market Data
      • GET: List of All Tokens
      • GET: Multi-Timeframe Technical Analysis
      • GET: Agent Details
      • POST: AI-Powered Query via NLQ
    • Best Practices
    • Conclusion
  • DappLooker Analytics
    • 🗃️Products
      • 📶Analytics
        • 🔎Browse and Search data
        • 📈Creating Charts
          • No-Code Charts
          • SQL Charts
        • 🔢Custom Values
        • 📊Dashboards
          • Create Dashboard
          • Add Charts to Dashboard
          • Discover Page
          • Link dashboard to another dashboard
          • Adding Filters to Dashboard
            • Time Filter
        • ♻️Convert No-Code to SQL
        • 🔗Making Charts and Dashboards Public
      • 🔍Subgraph Analyzer
      • ✨AI Studio
        • AI Studio API Support
      • 🤖DataBOT
        • 🎮Discord Bot
        • ▶️Telegram Bot
        • 🌐Connect with Leading Networks and dApps
      • 🔑DappLooker SDK
        • 🔎Tracking API Usage
    • 🌐Supported Networks
      • Blockchain Data
      • Smart Contracts
      • Subgraphs
      • SubQuery
      • Offchain Data Sources
    • 📲Registering Data
      • My Dashboard Overview
      • Smart Contracts
      • Subgraph
      • Subquery
      • Off-Chain Integration
    • 🔖Featured Projects
    • 🎯Features
      • XRay Feature
      • Filtering
      • Summarize
      • Downloading
        • Download Chart Data
      • Editor Panel
        • Preview Chart
        • Joining Data
        • Types Of Join Data
        • Sorting
        • Row Limit
        • Convert to models
        • Duplicate a Chart
        • New Collection
      • Creating Custom Column and Custom Expressions
      • 📷Screenshot
      • 🗃️Collections
        • Browse Collection
        • Personal Collection
        • Team Collection
    • ⛓️Smart Contract Live Query
    • 🔔Push Notifications
      • 👀Where to view notifications?
      • 📰Push x MetaMask Snaps
    • 👨‍⚖️Case Studies
      • 1️⃣Community Updates
      • 2️⃣DeFi Reports
      • 3️⃣On-Chain & Off-Chain Analysis
      • 4️⃣User Retention Analysis
      • 5️⃣DappLooker Telegram Bot
      • 6️⃣Subgraph Powered No-Code Dashboards
      • 7️⃣API Use Case: Beamswap
      • 8️⃣Embedding Use Case: GRTDataHub
    • 💰Pricing
      • Pricing Breakdown
      • Discounts And Payments
    • 💻Deploy a subgraph on the DappLooker custom node
    • 🥷DappLooker No-code Ninjas Program!
    • 🤝Sponsor With Us
    • 🔗Relevant Resources
    • ☎️Contact Us
  • API Guides
    • Get API Key
    • How to Get an API of a Chart
    • Render Chart or Dashboard as an Image with API
    • Mintbase
      • Individual Store Level APIs
      • Mintbase Protocol Level APIs
    • Nordek Developer APIs
  • Explorers
    • CeloSpy
    • VaraSpy
Powered by GitBook
On this page

Was this helpful?

  1. Data APIs for AI
  2. API Endpoints

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:

[
  {
    "id": "aixbt",
    "rug_status": "SAFE/HIGH_RISK/CAUTION/RUGGED",
    "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.0715800000",
      "resistance": "0.0834500000",
      "rsi": "45.78",
      "sma": "0.0772012000"
    },
    "agent_holder_insights": {
      "total_holder_count": 326210,
      "holder_count_change_percentage_24h": "0.03",
      "fifty_percentage_holding_wallet_count": "31.00",
      "first_100_buyers_initial_bought": "945882.24",
      "first_100_buyers_initial_bought_percentage": "0.09",
      "first_100_buyers_current_holding": "1981396.51",
      "first_100_buyers_current_holding_percentage": "0.20",
      "top_10_holder_balance": "348699164.93",
      "top_10_holder_percentage": "34.87",
      "top_50_holder_balance": "550048407.22",
      "top_50_holder_percentage": "55.00",
      "top_100_holder_balance": "595205545.84",
      "top_100_holder_percentage": "59.52"
    },
    "smart_money_insights": {
      "top_25_holder_buy_24h": "2826866.00",
      "top_25_holder_sold_24h": "2890278.30"
    },
    "dev_wallet_insights": {
      "wallet_address": "0x8dfb37aae4f8fcbd1f90015a9e75b48f50fd9f59",
      "wallet_balance": 0,
      "dev_wallet_total_holding_percentage": 0,
      "dev_wallet_outflow_txs_count_24h": 0,
      "dev_wallet_outflow_amount_24h": 0,
      "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.0763",
      "mcap": "64982005.00",
      "fdv": "75947917.00",
      "volume_24h": "26720879.00",
      "total_liquidity": "935081.80",
      "price_change_percentage_1h": "1.43",
      "price_change_percentage_24h": "1.37",
      "price_change_percentage_7d": "-0.93",
      "price_change_percentage_30d": "-23.96",
      "volume_change_percentage_7d": "-17.60",
      "volume_change_percentage_30d": "-66.70",
      "mcap_change_percentage_7d": "-1.00",
      "mcap_change_percentage_30d": "-23.20",
      "price_high_24h": "0.0788",
      "price_ath": "0.9426",
      "circulating_supply": "855612732.00",
      "total_supply": "1000000000.00"
    },
    "last_updated_at": "2025-04-17T07:57:13.944Z"
  }
]

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.

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.

PreviousGET: Multi-Timeframe Technical AnalysisNextPOST: AI-Powered Query via NLQ

Last updated 21 hours ago

Was this helpful?