Solscan

https://docs.solscan.io/
Admin
Solscan is the leading explorer for the Solana ecosystem, offering tools to analyze transactions,...
Tokens:14,200
Snippets:231
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Example API Request URL

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

A direct URL example demonstrating the structure of the instruction[] parameter for the enhanced transaction endpoint.

```markdown
<https://pro-api.solscan.io/v2.0/account/transactions/enhanced>
  ?address=DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M
  &instruction[]=DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23Mf223c68952e1f2b6
```

--------------------------------

### Query documentation via HTTP GET

Source: https://docs.solscan.io/llms.txt

Perform a GET request to the documentation index with 'ask' and 'goal' parameters to receive a direct answer.

```http
GET https://docs.solscan.io/master.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### GET /master.md

Source: https://docs.solscan.io/llms.txt

Performs a query against the documentation index to retrieve answers and relevant excerpts based on a specific question.

```APIDOC
## GET /master.md

### Description
Perform an HTTP GET request on the documentation index to retrieve a direct answer to a question along with relevant excerpts and sources.

### Method
GET

### Endpoint
https://docs.solscan.io/master.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the response.

### Request Example
GET https://docs.solscan.io/master.md?ask=How+do+I+view+transaction+details?&goal=Analyze+blockchain+data
```

--------------------------------

### cURL Request for Enhanced Transactions

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

A cURL command example for querying the enhanced transaction endpoint with specific filtering parameters.

```bash
curl --request GET \
  --url '<https://pro-api.solscan.io/v2.0/account/transactions/enhanced>
    ?address=DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M
    &instruction[]=DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23Mf223c68952e1f2b6
    &limit=10
    &encoding=jsonParsed' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### GET /account/transactions/enhanced

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieves a list of transactions for a specific account with optional filters for programs, instructions, tokens, time/slot ranges, and pagination.

```APIDOC
## GET /account/transactions/enhanced

### Description
Retrieves filtered transaction data for a given account address. Supports advanced filtering by program, instruction, token, and time or slot ranges.

### Method
GET

### Endpoint
https://pro-api.solscan.io/v2.0/account/transactions/enhanced

### Parameters
#### Query Parameters
- **address** (string) - Required - The account address to query.
- **program[]** (array) - Optional - List of program IDs to filter by.
- **instruction[]** (array) - Optional - List of instruction discriminators (hex) to filter by.
- **token[]** (array) - Optional - List of token mint addresses to filter by.
- **from_time** (integer) - Optional - Start timestamp (Unix).
- **to_time** (integer) - Optional - End timestamp (Unix).
- **from_slot** (integer) - Optional - Start slot number.
- **to_slot** (integer) - Optional - End slot number.
- **status** (integer) - Optional - Transaction status filter.
- **limit** (integer) - Optional - Number of results to return (default 40).
- **encoding** (string) - Optional - Format of transaction data (jsonParsed, json, base64, base58).
- **cursor** (string) - Optional - Pagination cursor for fetching subsequent pages.

### Request Example
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced?address=WALLET&program[]=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4&instruction[]=e517cb977ae3ad2a&limit=40' \
  --header 'token: YOUR_API_KEY'

### Response
#### Success Response (200)
- **data** (array) - List of transaction objects.

#### Response Example
{
  "data": [
    {
      "slot": 280000000,
      "transaction": {
        "signatures": ["..."],
        "instructions": [...]
      }
    }
  ]
}
```

--------------------------------

### 400 Bad Request Error Response

Source: https://docs.solscan.io/solscan-api/solscan-api-error-type.md

Example JSON response returned by the API when a validation error occurs.

```json
{
"success": false,
"errors": {
"code": 1100,
"message": "Validation Error: Address [TmUEfZi6dHe7DcFq2ALvB2tbB] is invalid" }
}
```

--------------------------------

### GET /v2.0/account/transactions/enhanced

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieves raw Solana transaction objects with server-side filtering capabilities, including filtering by program instruction.

```APIDOC
## GET /v2.0/account/transactions/enhanced

### Description
Returns raw Solana transaction objects with server-side filtering by time, slot, signature range, signer, token, program, and instruction discriminator.

### Method
GET

### Endpoint
https://pro-api.solscan.io/v2.0/account/transactions/enhanced

### Parameters
#### Query Parameters
- **address** (string) - Required - The account address to fetch transactions for.
- **instruction[]** (array) - Optional - Filters transactions where at least one instruction matches the provided program address and discriminator. Format: PROGRAM_ADDRESS + DISCRIMINATOR. Max 5 values.
- **limit** (integer) - Optional - Number of transactions to return.
- **encoding** (string) - Optional - The encoding format for the transaction data (e.g., jsonParsed).

### Request Example
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced?address=DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M&instruction[]=DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23Mf223c68952e1f2b6&limit=10&encoding=jsonParsed' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### GET /account/transactions/enhanced

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieves enhanced transaction data for a specific account, filtered by program ID and instruction discriminators.

```APIDOC
## GET /account/transactions/enhanced

### Description
Retrieves a list of transactions for a given account address, optionally filtered by program ID and specific instruction discriminators.

### Method
GET

### Endpoint
https://pro-api.solscan.io/v2.0/account/transactions/enhanced

### Parameters
#### Query Parameters
- **address** (string) - Required - The account address to fetch transactions for.
- **program[]** (string) - Optional - Array of program IDs to filter by.
- **instruction[]** (string) - Optional - Array of instruction discriminators to filter by.
- **status** (integer) - Optional - Transaction status filter (e.g., 1 for success).
- **limit** (integer) - Optional - Maximum number of transactions to return.

### Request Example
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced?address=WALLET&program[]=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4&instruction[]=e517cb977ae3ad2a&status=1&limit=40' \
  --header 'token: YOUR_API_KEY'

### Response
#### Success Response (200)
- **data** (array) - List of transaction objects matching the filter criteria.
```

--------------------------------

### GET /account/transactions/enhanced

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieve enhanced transaction data for an account, filtered by specific program addresses and instruction discriminators.

```APIDOC
## GET /account/transactions/enhanced

### Description
Retrieve filtered transaction history for a specific account by providing program addresses and instruction identifiers.

### Method
GET

### Endpoint
https://pro-api.solscan.io/v2.0/account/transactions/enhanced

### Parameters
#### Query Parameters
- **address** (string) - Required - The wallet address to query.
- **program[]** (array) - Optional - List of program IDs to filter by.
- **instruction[]** (array) - Optional - List of instruction discriminators to filter by.
- **status** (integer) - Optional - Transaction status filter (e.g., 1 for success).

### Request Example
```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced?address=WALLET&program[]=TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA&instruction[]=03&instruction[]=0c&status=1' \
  --header 'token: YOUR_API_KEY'
```
```

--------------------------------

### Initialize Anchor IDL

Source: https://docs.solscan.io/transaction-details/anchor-verified-programs.md

Command to publish an Anchor program IDL after deployment, enabling proper data display in Solana ecosystem tools.

```bash
anchor idl init -f <target/idl/program.json>
```

--------------------------------

### Fetch IDL via Anchor CLI

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Command to retrieve the IDL for a specific program on mainnet.

```bash
anchor idl fetch PROGRAM_ID --provider.cluster mainnet-beta
# Look for instructions[].name in the output
```

--------------------------------

### Filter Jupiter V6 Swaps

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieve specific swap transactions for a wallet by filtering for Jupiter V6 program instructions.

```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=WALLET
    &program[]=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4
    &instruction[]=e517cb977ae3ad2a
    &instruction[]=5703feb8e7573909
    &status=1
    &limit=40' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Paginate results with cursor

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Demonstrates how to iterate through transaction pages using a cursor derived from the last item's slot and signature.

```tsx
async function getAllInstructions(address: string, instructionHex: string) {
  const results = [];
  let cursor: string | undefined;

  do {
    const params = new URLSearchParams({
      address,
      'instruction[]': instructionHex,
      status: '1',
      limit: '40',
      ...(cursor ? { cursor } : {})
    });

    const res = await fetch(
      `https://pro-api.solscan.io/v2.0/account/transactions/enhanced?${params}`,
      { headers: { token: API_KEY } }
    );
    const { data } = await res.json();

    if (!data || data.length === 0) break;

    results.push(...data);
    // cursor from last item's slot + signature for next page
    const last = data[data.length - 1];
    cursor = `${last.slot}_${last.transaction.signatures[0]}`;

  } while (true);

  return results;
}
```

--------------------------------

### Instruction Parameter Breakdown

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

A breakdown of the components used to construct the combined instruction parameter value.

```markdown
Program address : DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M   (Jupiter DCA)
Discriminator   : f223c68952e1f2b6                                  (8-byte Anchor)
Instruction name: deposit  → sha256("global:deposit")[0..8]
Combined value  : DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23Mf223c68952e1f2b6
```

--------------------------------

### Filter PumpFun token launches

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Queries transactions for a specific address filtered by PumpFun program instructions.

```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P
    &instruction[]=181ec828051c0777
    &status=1
    &limit=40
    &encoding=jsonParsed' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Compute Anchor Discriminator in Python

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Uses the hashlib library to generate an 8-byte discriminator from an instruction name.

```python
import hashlib

def anchor_discriminator(instruction_name: str) -> str:
    h = hashlib.sha256(f"global:{instruction_name}".encode()).digest()
    return h[:8].hex()
```

--------------------------------

### Include API Key in cURL Request

Source: https://docs.solscan.io/solscan-api/how-to-generate-your-solscan-pro-api-key.md

Use this format to authenticate your requests by including the API key in the header.

```bash
// curl -X 'GET'
'https://pro-api.solscan.io/v2.0/account/transactions?account=ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx&limit=1'
-H 'accept: application/json'
-H 'token: {YOUR_API_KEY}'
```

--------------------------------

### Filter OpenBook V2 market maker activity

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieves market maker order activity within a specific slot range.

```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=MARKET_MAKER_WALLET
    &program[]=opnb2LAfJYbRMAHHvqjCwQxanZn7ReEHp1k81EohpZb
    &instruction[]=c00587a4401d171f
    &instruction[]=e725358372f26354
    &from_slot=280000000
    &to_slot=285000000
    &limit=40' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Filter USDC swaps on Jupiter V6

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieves transactions for a specific wallet involving Jupiter V6 swaps within a defined time window.

```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=WALLET
    &program[]=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4
    &instruction[]=e517cb977ae3ad2a
    &instruction[]=5703feb8e7573909
    &token[]=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
    &from_time=1720000000
    &to_time=1720086400
    &status=1
    &limit=40
    &encoding=jsonParsed' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Filter PumpFun Buys

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieve buy transactions for a specific wallet interacting with the PumpFun program.

```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=WALLET
    &program[]=6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P
    &instruction[]=66063d1201daebea
    &status=1' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Filter Raydium V4 Swaps via API

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieve all swap transactions for a specific wallet address interacting with the Raydium AMM V4 program.

```bash
# All Raydium V4 swaps for a wallet
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=WALLET
    &program[]=675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8
    &instruction[]=09
    &instruction[]=0b
    &status=1' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Filter SPL Token Transfers via API

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieve all token transfers or checked transfers for a specific wallet address.

```bash
# All token transfers (Transfer or TransferChecked) for a wallet
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=WALLET
    &program[]=TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
    &instruction[]=03
    &instruction[]=0c
    &status=1' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Filter Jupiter Limit Orders

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Retrieve limit order transactions for the Jupiter Limit Order program.

```bash
curl --request GET \
  --url 'https://pro-api.solscan.io/v2.0/account/transactions/enhanced
    ?address=jupoNjAxXgZ4rjzxzPMP4oxduvQsQtZzyknqvzYNrNu
    &instruction[]=5f81edf00831df84' \
  --header 'token: YOUR_API_KEY'
```

--------------------------------

### Decode Instruction Data in TypeScript

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Decodes a base58-encoded instruction data field to extract prefixes for Anchor or native programs.

```typescript
import bs58 from 'bs58';

// 'data' field from instruction in Solscan transaction detail
const dataBase58 = "3Bxs3zzLZLuLQEYX"; // example
const bytes = bs58.decode(dataBase58);

// For Anchor programs: first 8 bytes
const anchorPrefix = Buffer.from(bytes.slice(0, 8)).toString('hex');

// For native programs: first 1 byte
const nativePrefix = Buffer.from(bytes.slice(0, 1)).toString('hex');

console.log('8-byte prefix:', anchorPrefix);
console.log('1-byte prefix:', nativePrefix);
```

--------------------------------

### 400 Bad Request Error

Source: https://docs.solscan.io/solscan-api/solscan-api-error-type.md

Details regarding the 400 Bad Request error, which indicates that the client provided invalid data in the request parameters.

```APIDOC
## 400 Bad Request

### Description
This error occurs when invalid data is provided in one of the parameters, resulting in a client-side request error. The API cannot process the request due to this incorrect input.

### Solution
Verify the data being sent in the parameters. Make sure that all required fields are provided, the data types are correct, and any constraints or formatting rules are followed. Then, try the request again.

### Response Example
{
  "success": false,
  "errors": {
    "code": 1100,
    "message": "Validation Error: Address [TmUEfZi6dHe7DcFq2ALvB2tbB] is invalid"
  }
}
```

--------------------------------

### Compute Anchor Discriminator in TypeScript

Source: https://docs.solscan.io/solscan-api/api-transaction-enhanced-filtering-by-program-instruction.md

Uses the crypto module to generate an 8-byte discriminator from an instruction name.

```typescript
import { createHash } from 'crypto';

function anchorDiscriminator(instructionName: string): string {
  return createHash('sha256')
    .update(`global:${instructionName}`)
    .digest()
    .slice(0, 8)
    .toString('hex');
}

// Jupiter Limit Order — snake_case
anchorDiscriminator('cancel_order')           // "5f81edf00831df84"
anchorDiscriminator('initialize_order')       // "856e4aaf709ff59f"
anchorDiscriminator('fill_order')             // "e87a7319c78f88a2"

// Jupiter V6 — camelCase
anchorDiscriminator('route')                  // "e517cb977ae3ad2a"
anchorDiscriminator('sharedAccountsRoute')    // "5703feb8e7573909"

// PumpFun — single word
anchorDiscriminator('buy')                    // "66063d1201daebea"
anchorDiscriminator('sell')                   // "33e685a4017f83ad"
anchorDiscriminator('create')                 // "181ec828051c0777"
```

--------------------------------

### Metaplex Metadata JSON Schema

Source: https://docs.solscan.io/integration/update-token-details.md

The required JSON structure for populating the metadata field of a token.

```json
{
  "name": "Coin name",
  "symbol": "Symbol",
  "image": "Image link"
}
```
Tokens:
Raw