--- title: "Using the Solscan API to Retrieve Pump.fun Swap Activity" description: "Step-by-step guidance on how to use Solscan Pro API endpoint to retrieve Pump.fun activity and export swap data." url: https://info.solscan.io/using-solscan-api-to-retrieve-pump-fun-swap-activity/ tags: ["Developer"] published: 2025-08-19 updated: 2026-06-21 --- # Using the Solscan API to Retrieve Pump.fun Swap Activity ## Overview Pump.fun is a meme‑coin launch platform that supports decentralized trading of new tokens on Solana. It uses two programs: one implementing an automated market maker (AMM) for swaps and another implementing the bonding‑curve that sets prices. To monitor swap activity for a specific user, Solscan provides a `v2.0/account/defi/activities` API. This endpoint returns detailed DeFi activities such as token swaps, liquidity events, staking, etc. The documentation shows that it accepts parameters such as the wallet address, the program ID to filter by, a page number and page size for pagination and sort order [pro-api.solscan.io](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-defi-activities#:~:text=get). This article explains how to use this API to pull Pump.fun swap transactions, filter them by USD value and export them into a CSV file. ## Understanding the API ### Endpoint and Parameters Solscan’s _Account DeFi Activities_ endpoint (`GET /v2.0/account/defi/activities`) returns DeFi activities for a wallet. Key parameters include [pro-api.solscan.io](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-account-defi-activities#:~:text=get): Parameter Description address **Required.** The wallet address on Solana whose activities are queried. activity\_type Array of activity types to include. For swaps use `ACTIVITY_TOKEN_SWAP`. platform Array of platform program IDs to filter by. Up to 5 IDs. source Array of source program IDs to filter by. Up to 3 IDs (use Pump.fun program here). page Page number for pagination (integer). page\_size Number of items per page (allowed values: 10, 20, 30, 40, 60, 100). sort\_by Field used for sorting; `block_time` is the default. sort\_order `asc` or `desc` for ascending or descending order. The API response contains a `data` array. Each element includes fields such as: - `block_id`, `block_time` and `trans_id` to identify the block and transaction. - `activity_type`, `from_address` and `to_address`. - `token1`, `token1_decimals`, `amount1` and `token2`, `token2_decimals`, `amount2` specifying the swap tokens and their amounts. - `price1`, `price2` and `usd_value` giving the USD value of each side if available. ### Authentication Solscan’s Pro API requires an API key. According to the Pro API documentation, you must supply the key in a custom HTTP header named `token`[docs.solscan.io](https://docs.solscan.io/api-access/how-to-generate-your-solscan-pro-api-key#:~:text=Copy). When using `curl` or any HTTP client, set `-H 'token: '`. 🚨 **Warning: Never share your API key publicly.** ### Determining Pump.fun Program IDs Pump.fun uses two Solana programs: - **Swap program** (AMM): `pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA` - **Bonding‑curve program**: `6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P` To monitor swap activity you only need the AMM program. Pass it in the `source` parameter when calling the API. ## Solutions for Pulling Swap Activity ### Solution 1 – Use `curl`/Python to call the API directly You can build a script to call the API, paginate through results and export them to CSV. The steps are: 1. **Prepare query parameters:** set `address` to the wallet you want (e.g. `GFF...T7y`), `source` to the swap program ID, `activity_type` to `ACTIVITY_TOKEN_SWAP`, `page_size` to `100` and `sort_order` to `desc`. 2. **Paginate:** loop `page=1,2,…` until you retrieve the desired number of records (e.g. 1000 swaps = 10 pages × 100 records). Stop when the returned `data` array is empty. 3. **Filter by USD value:** Each record includes `amount1`, `token1`, `amount2`, `token2` and, if available, `price1` and `price2`. If price fields are missing you can call Solscan’s _Token Price_ endpoint ( `/v2.0/market/token/price` ) to fetch historical USD prices[pro-api.solscan.io](https://pro-api.solscan.io/pro-api-docs/v2.0/reference/v2-token-price#:~:text=Get%20price%20of%20a%20token). Multiply amount by price to compute the USD value and discard records below $1. 4. **Write CSV:** Save records with fields like date/time (`block_time` converted to ISO date), transaction ID, token symbols, amounts and USD values. **Example in Python:** ``` python CopyEdit import csv, requests, time API_KEY = "" BASE_URL = "https://pro-api.solscan.io/v2.0/account/defi/activities" ADDRESS = "GFF4...YT7y" SOURCE = "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA" headers = {"token": API_KEY} page = 1 page_size = 100 results = [] while len(results) < 1000: params = { "address": ADDRESS, "activity_type": "ACTIVITY_TOKEN_SWAP", "source": SOURCE, "page": page, "page_size": page_size, "sort_by": "block_time", "sort_order": "desc", } resp = requests.get(BASE_URL, headers=headers, params=params) resp.raise_for_status() data = resp.json().get("data", []) if not data: break # no more records results.extend(data) page += 1 time.sleep(0.1) # avoid rate‑limits # optionally truncate to 1000 records data1000 = results[:1000] # filter by USD value > $1 – compute if price fields available filtered = [] for row in data1000: usd = row.get("usd_value") # if Solscan already provides USD value if usd is None: usd = 0 # compute using token price endpoint if necessary if usd > 1: filtered.append(row) # write to CSV with open("/home/oai/share/pump.fun_swap.csv", "w", newline="") as f: writer = csv.writer(f) writer.writerow(["block_time","trans_id","token1","amount1","token2","amount2","usd_value"]) for row in filtered: writer.writerow([ row["block_time"], row["trans_id"], row.get("token1"), row.get("amount1"), row.get("token2"), row.get("amount2"), row.get("usd_value"), ]) print("Export completed!") ``` **Pros:** - Completely automated; you can fetch 1000+ records and filter them programmatically. - Scripts allow further analytics (e.g. time‑series analysis, distribution of swap sizes). **Cons:** - You must handle API rate‑limits by adding delays between requests. ### Solution 2 – Use Solscan’s interactive API docs (manual) The Pro API docs include a “Try It!” button that sends requests with your API key automatically. You can supply the address, activity type and program ID in the form and view the JSON response. This is helpful for testing parameters and inspecting a few records. However, it only returns one page at a time and does not support exporting to CSV. You would need to copy results manually and combine them yourself. ![Use Solscan’s interactive API docs to retrieve Pump.fun activity](https://info.solscan.io/using-solscan-api-to-retrieve-pump-fun-swap-activity/images/2025/08/KB-API-pump-swap.png) Solscan’s interactive API docs interface **Pros:** - Convenient for exploring the API without writing code. - Good for verifying query parameters and previewing response structure. **Cons:** - Manual; cannot fetch large datasets efficiently. - Your API key appears in the request snippet, so be careful not to expose it when sharing screenshots. ## Conclusion and Recommendation Solscan’s Pro API offers a rich endpoint (`/account/defi/activities`) for retrieving on‑chain swap data. By filtering on the Pump.fun AMM program ID and the `ACTIVITY_TOKEN_SWAP` activity type, you can obtain detailed swap activity for any wallet. The key steps are: - Supply your API key via the `token` header. - Paginate through results (page 1 through page n) because the API caps `page_size` at 100. - Compute USD values using the `value` fields or the token price endpoint and filter transactions above your threshold (e.g. > $1). - Export the filtered data to a CSV file for analysis.