Bundled Transactions

Retrieve bundled transactions associated with a token, with pagination support.

Endpoint

GET https://enterprise.guardis.io/v1/market/bundled-transactions

Authentication

Include your API key in the X-API-Key header.

X-API-Key: your_api_key_here

---

Query Parameters

Parameter	Type	Required	Description
token_address	string	Yes	The mint address of the token
page	number	No	Page number (1-indexed, defaults to 1)
per_page	number	No	Number of items per page (defaults to 20)
order_by	string	No	Field name to sort by
order_dir	string	No	Sort direction: "asc" or "desc"

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/market/bundled-transactions?token_address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "X-API-Key: your_api_key_here"

With pagination:

curl -X GET "https://enterprise.guardis.io/v1/market/bundled-transactions?token_address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&page=2&per_page=10" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

{
  "items": [
    {
      "transaction_id": "5K8s...txid",
      "signing_address": "7xKX...addr",
      "solana_amount": "1.5"
    },
    {
      "transaction_id": "3Rp2...txid",
      "signing_address": "9mNQ...addr",
      "solana_amount": "0.75"
    }
  ],
  "total": 42,
  "page": 1,
  "per_page": 20,
  "pages": 3
}

---

Field Reference

Response Structure

Field	Type	Description
items	array	Array of bundled transaction objects
total	number	Total number of items across all pages
page	number	Current page number (1-indexed)
per_page	number	Number of items per page
pages	number	Total number of pages

Bundled Transaction Object

Field	Type	Description
transaction_id	string	The Solana transaction signature
signing_address	string	The wallet address that signed the transaction
solana_amount	string	The amount of SOL involved in the transaction

Note: Decimal values are returned as strings to preserve precision.

---

Example Usage

JavaScript:

const tokenAddress = "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263";

const response = await fetch(
  `https://enterprise.guardis.io/v1/market/bundled-transactions?token_address=${tokenAddress}&page=1&per_page=10`,
  {
    headers: {
      "X-API-Key": "your_api_key_here"
    }
  }
);

const data = await response.json();

console.log(`Total bundled transactions: ${data.total}`);
console.log(`Page ${data.page} of ${data.pages}`);

data.items.forEach(tx => {
  console.log(`TX: ${tx.transaction_id} | Signer: ${tx.signing_address} | Amount: ${tx.solana_amount} SOL`);
});

Python:

import requests

token_address = "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

response = requests.get(
    "https://enterprise.guardis.io/v1/market/bundled-transactions",
    params={
        "token_address": token_address,
        "page": 1,
        "per_page": 10
    },
    headers={"X-API-Key": "your_api_key_here"}
)

data = response.json()

print(f"Total bundled transactions: {data['total']}")
print(f"Page {data['page']} of {data['pages']}")

for tx in data["items"]:
    print(f"TX: {tx['transaction_id']} | Signer: {tx['signing_address']} | Amount: {tx['solana_amount']} SOL")

---

Error Responses

Status Code	Description
400	Missing or invalid token_address parameter
401	Missing or invalid API key
404	Bundled transactions not found for the provided token
500	Internal server error

{
  "code": 400,
  "message": "Missing required parameter: token_address"
}

{
  "code": 404,
  "message": "Bundled transactions not found for the provided token address"
}