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:
Sample Response:
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.
Last updated
Was this helpful?