# Staking Intelligence

### **Endpoint**

<mark style="color:yellow;">**GET**</mark> <mark style="color:orange;">`https://api.dapplooker.com/v1/stake-trends`</mark>

> #### 💡 Pro **Tips**&#x20;
>
> * Use this endpoint to **track staking inflows/outflows** and measure token health via TVL, net staked %, and retention rate.
> * Analyze **24h staking trends** (stake count, stake amount, unstake activity) to spot accumulation or withdrawal spikes.
> * Leverage **transaction-level data** (staking\_activities) to monitor whale moves, top wallets staking, and timing of big deposits/withdrawals.
> * Perfect for building **on-chain dashboards** showing staking adoption, liquidity trends, and token holder participation over time.
> * This endpoint is **x402 payment–enabled**, opening access for all users — simply **pay and use** without needing an API key.

### **Authentication**

This endpoint supports **two authentication methods**:

<table data-header-hidden><thead><tr><th width="254.30078125"></th><th></th></tr></thead><tbody><tr><td><strong>Method</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>API Key</strong></td><td>Provide your Loky API key using the <mark style="color:orange;"><code>api_key</code></mark> parameter for authenticated access.</td></tr><tr><td><strong>x402 Payment Protocol</strong></td><td>If <mark style="color:orange;"><code>api_key</code></mark> is not provided, the request automatically uses the <a href="https://x402.gitbook.io/x402">x402 protocol</a> for on-chain payment verification.</td></tr></tbody></table>

For seamless integration, user can follow the [**x402 Quickstart Guide for Buyers**](https://x402.gitbook.io/x402/getting-started/quickstart-for-buyers).

### **Query Parameters**

<table data-header-hidden><thead><tr><th width="179.36328125"></th><th width="108.828125"></th><th width="153.64453125"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td><strong>Type</strong></td><td><strong>Mandatory</strong></td><td><strong>Description</strong></td></tr><tr><td><mark style="color:orange;"><code>api_key</code></mark></td><td>string</td><td>No</td><td>Your unique API key used for authentication</td></tr><tr><td><mark style="color:orange;"><code>token_tickers</code></mark></td><td>string</td><td>No</td><td>Comma-separated token tickers (upto 30)</td></tr><tr><td><mark style="color:orange;"><code>token_addresses</code></mark></td><td>string</td><td>No</td><td>Comma-separated token addresses (upto 30)</td></tr></tbody></table>

### **Sample Request**

{% code overflow="wrap" %}

```bash
# With Token Tickers
curl --location 'https://api.dapplooker.com/v1/stake-trends?api_key=<API_KEY>&token_tickers=1000X'

# With Token Addresses
curl --location 'https://api.dapplooker.com/v1/stake-trends?api_key=<API_KEY>&token_addresses=0x352b850b733ab8bab50aed1dab5d22e3186ce984'
```

{% endcode %}

### **Sample Response**

```json
{
  "success": true,
  "data": [
    {
      "staking_details": {
        "name": "1000x by Virtuals",
        "ticker": "1000X",
        "contract_address": "0x352b850b733ab8bab50aed1dab5d22e3186ce984",
        "latest_price": 0.0087,
        "volume_usd_24h": 107961,
        "price_change_percentage_24h": 22.3,
        "stake_retention_percentage": 7.1,
        "tvl": 564047.2,
        "net_staked": "3.4M",
        "net_staked_usd": "29.4K",
        "net_staked_percentage": 0.34,
        "total_stakers": 253,
        "total_withdrawn": 11782045.9,
        "total_withdrawn_percentage": 1.2,
        "token_holders": 82344
      },
      "trends": {
        "stake_count_24h": 1,
        "stake_amount_24h": 4253.6,
        "stake_amount_usd_24h": 37.1,
        "unstake_count_24h": 0,
        "unstake_amount_24h": 0,
        "unstake_amount_usd_24h": 0
      },
      "staking_activities": [
        {
          "tx_hash": "0x9835740bc863b9399547e3f744b02291f746682816e5dce464dd21f3a503ce6c",
          "wallet_address": "0xcfa985eafeacd824135173deb3fde50c05ac2ce1",
          "action": "Stake",
          "amount": 4253.611406,
          "timestamp": "2025-09-11T01:32:23",
          "token_address": "0x352b850b733ab8bab50aed1dab5d22e3186ce984",
          "user_type": "regular"
        },
        {
          "tx_hash": "0x559c8fdf733b192f022fcab0d8873a23afc250c5fd8f79b3ead92b503d92e4f1",
          "wallet_address": "0x00c2af578daa23df35a46ccd6d7982333f993517",
          "action": "Unstake",
          "amount": 943.7185,
          "timestamp": "2025-09-10T07:41:11",
          "token_address": "0x352b850b733ab8bab50aed1dab5d22e3186ce984",
          "user_type": "regular"
        }
        ...
      ]
    }
  ]
}
```

### **Response Fields Explanation**

#### **Staking Details**

* <mark style="color:orange;">`name`</mark> (string): Name of the agent.
* <mark style="color:orange;">`ticker`</mark> (string): Token Name.
* <mark style="color:orange;">`contract_address`</mark> (string): Contract address of the token.
* <mark style="color:orange;">`latest_price`</mark> (decimal): Current token price in USD.
* <mark style="color:orange;">`volume_usd_24h`</mark> (decimal): Trading volume of the token in the last 24 hours (USD).
* <mark style="color:orange;">`price_change_percentage_24h`</mark> (decimal): Percentage change in token price over the last 24 hours.
* <mark style="color:orange;">`stake_retention_percentage`</mark> (decimal): Percentage of stakers that restake.
* <mark style="color:orange;">`tvl`</mark> (decimal): Total Liquidity of token in (USD).
* <mark style="color:orange;">`net_staked`</mark> (string): Net number of tokens currently staked (formatted with suffix like K/M).
* <mark style="color:orange;">`net_staked_usd`</mark> (string): Net staked value in USD (formatted with suffix).
* <mark style="color:orange;">`net_staked_percentage`</mark> (decimal): Percentage of tokens staked relative to supply.
* <mark style="color:orange;">`total_stakers`</mark> (integer): Total number of unique wallets participating in staking.
* <mark style="color:orange;">`total_withdrawn`</mark> (decimal): Total amount of tokens withdrawn from staking.
* <mark style="color:orange;">`total_withdrawn_percentage`</mark> (decimal): Percentage of tokens withdrawn relative to supply.
* <mark style="color:orange;">`token_holders`</mark> (integer): Total number of token holders.

#### **Trends**

* <mark style="color:orange;">`stake_count_24h`</mark> (integer): Number of staker in the last 24 hours.
* <mark style="color:orange;">`stake_amount_24h`</mark> (decimal): Total token amount staked in the last 24 hours.
* <mark style="color:orange;">`stake_amount_usd_24h`</mark> (decimal): Total USD value of tokens staked in the last 24 hours.
* <mark style="color:orange;">`unstake_count_24h`</mark> (integer): Number of stakers who unstaked in the last 24 hours.
* <mark style="color:orange;">`unstake_amount_24h`</mark> (decimal): Total token amount unstaked in the last 24 hours.
* <mark style="color:orange;">`unstake_amount_usd_24h`</mark> (decimal): Total USD value of tokens unstaked in the last 24 hours.

#### **Staking Activities**

* <mark style="color:orange;">`tx_hash`</mark> (string): Transaction hash of the stake/unstake transaction.
* <mark style="color:orange;">`wallet_address`</mark> (string): Wallet address of the user performing the action.
* <mark style="color:orange;">`action`</mark> (string): Type of action — `"Stake"` or `"Unstake"`.
* <mark style="color:orange;">`amount`</mark> (decimal): Amount of tokens staked or unstaked.
* <mark style="color:orange;">`timestamp`</mark> (datetime): Date and time when the action occurred.
* <mark style="color:orange;">`token_address`</mark> (string): Token address of the token.
* <mark style="color:orange;">`user_type`</mark> (string): User classification (e.g., `regular`, `smart_money_user`, `dev`).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapplooker.com/data-apis-for-ai/staking-intelligence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.