--- title: "How to Check Token DeFi Activities Using Solscan Pro API" description: "Guide on using Solscan Pro API’s Token DeFi Activities endpoint to track swaps, liquidity, staking, and other token actions." url: https://info.solscan.io/check-token-defi-activities-using-solscan-pro-api/ tags: ["Developer"] published: 2025-08-27 updated: 2026-06-21 --- # How to Check Token DeFi Activities Using Solscan Pro API The Solscan Pro API allows you to track DeFi activities involving a particular token on the Solana blockchain. Using the **Token DeFi Activities** endpoint, you can query transactions such as token swaps, liquidity additions/removals, staking, and more. Apply filters for activity types (e.g., direct or aggregated swaps), time periods, platforms, or specific sources to retrieve details like token addresses, amounts, values, and platforms. This guide details the process and includes an example focused on token swaps. ## The Process To retrieve DeFi activities for a specific token using the Solscan Pro API, follow these steps: 1. **Access the Token DeFi Activities Endpoint** Use the endpoint: `GET . This fetches DeFi activities associated with a specified token on the Solana blockchain. 2. **Specify the Token Address** Include the `address` parameter with the token’s mint address (e.g., for SOL or USDC). This is required to retrieve all DeFi activities involving the token. 3. **Filter by Activity Type** Set the `activity_type` parameter as an array to focus on specific DeFi actions. For token swaps, use `ACTIVITY_TOKEN_SWAP` for direct swaps or `ACTIVITY_AGG_TOKEN_SWAP` for aggregated swaps (e.g., via Jupiter). You can include multiple types, such as `["ACTIVITY_TOKEN_SWAP", "ACTIVITY_AGG_TOKEN_SWAP"]`. Other supported types include `ACTIVITY_TOKEN_ADD_LIQ` (add liquidity), `ACTIVITY_TOKEN_REMOVE_LIQ` (remove liquidity), `ACTIVITY_POOL_CREATE` (create pool), `ACTIVITY_SPL_TOKEN_STAKE` (stake), `ACTIVITY_SPL_TOKEN_UNSTAKE` (unstake), `ACTIVITY_TOKEN_DEPOSIT_VAULT` (deposit to vault), `ACTIVITY_TOKEN_WITHDRAW_VAULT` (withdraw from vault), `ACTIVITY_SPL_INIT_MINT` (initialize mint), and `ACTIVITY_ORDERBOOK_ORDER_PLACE` (place orderbook order). 4. **Optional: Filter by Specific Tokens** Use the `token` parameter to narrow down activities involving an additional token address (e.g., for token pairs in swaps). 5. **Optional: Filter by Time Period** Add the `from_time` and `to_time` parameters to limit results to a specific timeframe. Use Unix timestamps (in seconds) for the start and end of the period. Note: The `block_time` parameter is deprecated and should be avoided. 6. **Optional: Filter by DeFi Platform** Include the `platform` parameter as an array of up to 5 platform program addresses to target activities on specific platforms (e.g., Orca, Raydium). For example, Orca’s Whirlpool program address is `whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc`. 7. **Optional: Account Filters** - `from`: Filter activities originating from a specific wallet address. - `source`: Filter by an array of up to 5 source addresses (e.g., related accounts or programs). 8. **Handle Pagination and Sorting** Use `page` (page number) and `page_size` (10, 20, 30, 40, 60, or 100 items per page) for pagination. Sort results with `sort_by=block_time` and `sort_order=asc` or `desc`. 9. **Review the Response Data** The API returns a list of activities with details such as: - **Token addresses**: Tokens involved (e.g., input/output for swaps). - **Amounts and values swapped**: Quantities and estimated USD values (for swaps). - **Platform**: The DeFi platform or aggregator involved. - Additional metadata like transaction signatures, timestamps, source addresses, and balance changes. 10. **Authenticate the Request** Include your Solscan Pro API key in the header: `-H 'token: '`. ## Example Suppose you want to retrieve DeFi activities for the USDC token, focusing on token swaps (direct and aggregated via Jupiter) on Orca, between January 1, 2025, and February 1, 2025. ### Sample Request (using cURL): ```cURL curl -X GET "" \\ -H "accept: application/json" \\ -H "token: " ``` - **Parameters Explained**: - `address=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`: USDC token address. - `activity_type[]=ACTIVITY_TOKEN_SWAP&activity_type[]=ACTIVITY_AGG_TOKEN_SWAP`: Filters for direct and aggregated token swaps. - `token=So11111111111111111111111111111111111111112`: Additional filter for SOL (e.g., SOL/USDC pairs). - `platform[]=whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc`: Orca’s Whirlpool program address. - `from_time=1735689600`: Unix timestamp for January 1, 2025 (00:00:00 UTC). - `to_time=1738368000`: Unix timestamp for February 1, 2025 (00:00:00 UTC). - `page_size=20`: Returns 20 items per page. - `sort_by=block_time&sort_order=desc`: Sorts by block time in descending order. - ``: Your Solscan Pro API key. ### Sample Response (simplified JSON): ```JSON { "data": [ { "tx_signature": "3x...abc", "block_time": 1736000000, "activity_type": "ACTIVITY_TOKEN_SWAP", "platform": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc", "tokens_in": { "token_address": "So11111111111111111111111111111111111111112", "amount": 1.5, "value_usd": 150.0 }, "tokens_out": { "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": 150.0, "value_usd": 150.0 } }, { "tx_signature": "4y...xyz", "block_time": 1736100000, "activity_type": "ACTIVITY_AGG_TOKEN_SWAP", "platform": "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33Zr9hX", "tokens_in": { "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": 100.0, "value_usd": 100.0 }, "tokens_out": { "token_address": "So11111111111111111111111111111111111111112", "amount": 0.9, "value_usd": 90.0 } } ], "next_page": 2 } ``` This response shows two swap activities involving USDC: one direct on Orca (SOL to USDC) and one aggregated via Jupiter (USDC to SOL), with pagination support. For more advanced usage and full documentation, visit [https://pro-api.solscan.io/pro-api-docs/v2.0](https://pro-api.solscan.io/pro-api-docs/v2.0) to explore API plans, additional endpoints, and detailed references. Unlock deeper insights into Solana token activities today!