# Solscan — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Solscan provides 23 callable API endpoints through the Parse marketplace.

**Category:** Web3 & Onchain | **Website:** [solscan.io/](https://solscan.io/) | **Docs:** [parse.bot/marketplace/1553ba38-4347-4d9c-bae3-63f358e4f1e7/solscan-io-api](https://parse.bot/marketplace/1553ba38-4347-4d9c-bae3-63f358e4f1e7/solscan-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_account_balance_changes

Get historical balance changes for a specific Solana address.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Solana account address (base58 public key). |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_account_balance_changes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_account_defi_activities

Get DeFi activity positions for a specific Solana address. Returns an array of DeFi activities (may be empty if the account has no DeFi positions).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Solana account address (base58 public key). |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_account_defi_activities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_account_detail

Get details for a specific Solana account/address including balance, owner program, and type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Solana account address (base58 public key). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_account_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>"}'
```

### get_account_token_accounts

Get token holdings for a specific Solana address.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Solana account address (base58 public key). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_account_token_accounts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>"}'
```

### get_account_transactions

Get transaction history for a specific Solana address.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Solana account address (base58 public key). |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of transactions per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_account_transactions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_analytics_accounts

Get account-level analytics over a time range. Returns daily active wallets, new accounts, new SPL tokens, or new NFTs depending on filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter` | string | No | Analytics filter. Accepted values: active_wallets, new_accounts, new_spl_tokens, new_nfts. |
| `range` | integer | No | Time range in days. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_analytics_accounts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":"<string>","range":"<integer>"}'
```

### get_analytics_network

Get network-level analytics data over a time range. Supports block count and average block time, or network fees depending on filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter` | string | No | Analytics filter. Accepted values: blocks, network_fees. |
| `range` | integer | No | Time range in days. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_analytics_network \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":"<string>","range":"<integer>"}'
```

### get_analytics_transactions

Get transaction-level analytics over a time range. Returns daily TPS and success rate, or vote transactions, or instruction counts depending on filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter` | string | No | Analytics filter. Accepted values: tps, vote_txs, instructions. |
| `range` | integer | No | Time range in days. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_analytics_transactions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":"<string>","range":"<integer>"}'
```

### get_block_detail

Get details for a specific block by its slot number. Returns blockhash, validator, fee rewards, transaction count, epoch, and parent slot info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `block_number` | string | Yes | Block slot number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_block_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"block_number":"<string>"}'
```

### get_block_list

Get a list of recent blocks. Each entry includes slot, blockTime, blockhash, validator, fee rewards, and transaction counts. The upstream API accepts limit values of 8 or 400.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of blocks to return. Accepted values: 8 or 400. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_block_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_defi_activities

Get real-time swap activities for a specific DeFi platform.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `app_id` | string | Yes | DeFi platform identifier (e.g. raydium, orca, meteora). |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of activities per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_defi_activities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_defi_dashboard

Get metrics for a specific DeFi AMM platform including daily TVL, volume, and trading counts. Returns an array of daily metric objects broken down by platform program IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `app_id` | string | Yes | DeFi platform identifier. Known values: raydium, orca, meteora. |
| `time_range` | integer | No | Time range in days for metrics. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_defi_dashboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id":"<string>","time_range":"<integer>"}'
```

### get_defi_markets

Get market pools for a specific DeFi platform with trading volume and TVL. Returns pool details including token pairs, 24h trades, volume, and TVL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `app_id` | string | Yes | DeFi platform identifier. Known values: raydium, orca, meteora. |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of markets per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_defi_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_leaderboard_programs

Get top Solana programs by usage over a time range. Returns program address, number of transactions, success rate, and active users.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `range` | integer | No | Time range in days for the leaderboard. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_leaderboard_programs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"range":"<integer>"}'
```

### get_mev_activity

Get recent MEV (sandwich) attack activity including attacker/victim addresses, buy/sell transactions, profit delta, and token pairs involved.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of MEV activities per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_mev_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>"}'
```

### get_network_stats

Get real-time Solana network stats including epoch info, TPS, validator count, SOL supply, and stake overview. Returns a snapshot of the current network state.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_network_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_token_detail

Get detailed info for a Solana token by its mint address including name, symbol, price, decimals, and reputation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token mint address (base58 public key). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_token_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>"}'
```

### get_token_holders

Get paginated list of top holders for a token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token mint address (base58 public key). |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of holders per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_token_holders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_token_leaderboard

Get top tokens sorted by market cap, holders, price, or 24h price change. Returns token address, market_cap, price, holder count, TVL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of tokens per page. |
| `sort_by` | string | No | Sort field. Accepted values: market_cap, holder, price, price_24h_change. |
| `sort_order` | string | No | Sort order. Accepted values: desc, asc. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_token_leaderboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","sort_by":"<string>","sort_order":"<string>"}'
```

### get_token_transactions

Get recent transfers involving a specific token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token mint address (base58 public key). |
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of transfers per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_token_transactions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### get_transaction_detail

Get full details for a transaction by its signature. Returns parsed instructions, SOL and token balance changes, fee, status, signer, and raw transaction data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tx_signature` | string | Yes | Transaction signature hash (base58-encoded string). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_transaction_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tx_signature":"<string>"}'
```

### get_transaction_list

Get a list of the most recent transactions on Solana. Each entry includes txHash, blockTime, fee, status, signer, and parsedInstruction summary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of transactions to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_transaction_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_whale_tracking

Get real-time whale transaction tracking showing large transfers on Solana. Returns transfer details including from/to addresses, value in USD, token, and source program.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |
| `page_size` | integer | No | Number of whale transactions per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-solscan-io-api-1553ba38/get_whale_tracking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>"}'
```