Cambrian Token Transaction Feed (Time Bounded) API

By Cambrian Network solana

GET /api/v1/solana/token-transactions-time-bounded

Token Transactions (Time Bounded)

Get detailed transaction data for any SPL token with precise Unix timestamp filtering for historical analysis and event-driven research.

Business Value

  • Historical Analysis: Enables precise time-bounded queries for tracking token activity during specific events or periods
  • Event-Driven Research: Perfect for analyzing token behavior around announcements, launches, or market events
  • Transaction Tracking: Comprehensive view of all buy/sell transactions with DEX information and pricing data
  • Real-time Monitoring: Track recent transaction activity with slot-level precision for up-to-the-minute insights
  • Multi-DEX Coverage: Aggregates transaction data across major Solana DEXs including Meteora, Raydium CLMM, and others

Endpoint Details

URL: 

https://opabinia.cambrian.network/api/v1/solana/token-transactions-time-bounded

Method: GET
Authentication: Required via X-API-Key header

Query Parameters

Parameter Type Required Default Description
token_address String Yes - Token program address (base58-44 string). See tokens for valid addresses.
after_time Integer Yes - Unix timestamp - start time for data range
before_time Integer Yes - Unix timestamp - end time for data range
limit Integer No 100 Limit the number of results. Maximum 1000, minimum 1.
offset Integer No 0 Offset the results, allows you to skip a number of rows before starting to return rows. Maximum 100000, minimum 0.

Response Field Descriptions

Response Field Type Description
signature String Transaction signature identifier
slot UInt64 Solana blockchain slot number when transaction was processed
txType String Type of transaction (buy/sell)
tokenAmount Float64 Amount of tokens transacted
valueUSD Float64 USD value of the transaction
priceUSD Float64 USD price per token at time of transaction
dex String Decentralized exchange where transaction occurred
poolAddress String Address of the liquidity pool used for the transaction

Examples

1. Recent SOL Transactions Analysis

Query recent SOL transactions within a 24-hour period to analyze trading patterns and market activity.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/token-transactions-time-bounded?token_address=So11111111111111111111111111111111111111112&after_time=1735689600&before_time=1735776000&limit=5" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "signature",
      "type": "String"
    },
    {
      "name": "slot",
      "type": "UInt64"
    },
    {
      "name": "txType",
      "type": "String"
    },
    {
      "name": "tokenAmount",
      "type": "Float64"
    },
    {
      "name": "valueUSD",
      "type": "Float64"
    },
    {
      "name": "priceUSD",
      "type": "Float64"
    },
    {
      "name": "dex",
      "type": "String"
    },
    {
      "name": "poolAddress",
      "type": "String"
    }
  ],
  "data": [
    [
      "5NY1QG3qHqr333JHWgxnPVJsqgKdyHtcvybQLkpBmhft8jXtprBgXgR3KM1fbniBGcnanV1vdyzTQnDEDYMzohBW",
      311292616,
      "buy",
      5.540280975,
      1074.4584055063153,
      193.9357246238428,
      "Meteora",
      "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
    ],
    [
      "4Dqa1fme5FfHC1iBJ9jUPVbRsDJ92SmSAyFP138R5ybUiX38UC9XVxB9ZKjmj7nXoo27PCc5Ew76SedE1e33cfVz",
      311292616,
      "buy",
      0.074712157,
      14.489356306005309,
      193.9357246238428,
      "Meteora",
      "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
    ],
    [
      "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
      311292616,
      "sell",
      11.319778006,
      2195.309350174648,
      193.9357246238428,
      "Raydium CLMM",
      "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
    ],
    [
      "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
      311292616,
      "sell",
      11.319778006,
      2195.309350174648,
      193.9357246238428,
      "Raydium CLMM",
      "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
    ],
    [
      "2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
      311292616,
      "sell",
      11.344764636,
      2200.1551503696064,
      193.9357246238428,
      "Raydium CLMM",
      "EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
    ]
  ],
  "rows": 5
}

The response returns 5 SOL transactions showing both buy and sell activity across Meteora and Raydium CLMM DEXs. Each transaction includes the exact slot number, transaction signature, token amounts, USD values, and pool addresses. Notice the consistent SOL price of ~$194 during this period, with transaction sizes ranging from 0.07 to 11.34 SOL.

2. Extended Historical Range

Query transactions over a longer time period to analyze trading volume and patterns.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/token-transactions-time-bounded?token_address=So11111111111111111111111111111111111111112&after_time=1735603200&before_time=1735776000&limit=10&offset=0" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "signature",
      "type": "String"
    },
    {
      "name": "slot",
      "type": "UInt64"
    },
    {
      "name": "txType",
      "type": "String"
    },
    {
      "name": "tokenAmount",
      "type": "Float64"
    },
    {
      "name": "valueUSD",
      "type": "Float64"
    },
    {
      "name": "priceUSD",
      "type": "Float64"
    },
    {
      "name": "dex",
      "type": "String"
    },
    {
      "name": "poolAddress",
      "type": "String"
    }
  ],
  "data": [
    [
      "5NY1QG3qHqr333JHWgxnPVJsqgKdyHtcvybQLkpBmhft8jXtprBgXgR3KM1fbniBGcnanV1vdyzTQnDEDYMzohBW",
      311292616,
      "buy",
      5.540280975,
      1074.4584055063153,
      193.9357246238428,
      "Meteora",
      "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
    ],
    [
      "4Dqa1fme5FfHC1iBJ9jUPVbRsDJ92SmSAyFP138R5ybUiX38UC9XVxB9ZKjmj7nXoo27PCc5Ew76SedE1e33cfVz",
      311292616,
      "buy",
      0.074712157,
      14.489356306005309,
      193.9357246238428,
      "Meteora",
      "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
    ],
    [
      "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
      311292616,
      "sell",
      11.319778006,
      2195.309350174648,
      193.9357246238428,
      "Raydium CLMM",
      "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
    ],
    [
      "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
      311292616,
      "sell",
      11.319778006,
      2195.309350174648,
      193.9357246238428,
      "Raydium CLMM",
      "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
    ],
    [
      "2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
      311292616,
      "sell",
      11.344764636,
      2200.1551503696064,
      193.9357246238428,
      "Raydium CLMM",
      "EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
    ]
  ],
  "rows": 5
}

This extended query demonstrates the flexibility of time-bounded filtering, allowing analysis of token activity over custom date ranges for deeper market insights and trend analysis.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2) — pay $0.05 USDC per request using blockchain micropayments. No API key required.

Quick Start (TypeScript)

npm install @x402/fetch @x402/evm viem

import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
  "https://deep42.cambrian.network/api/v1/solana/token-transactions-time-bounded"
);
const data = await response.json();

Quick Start (Python)

pip install "x402[httpx]"

import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get("https://deep42.cambrian.network/api/v1/solana/token-transactions-time-bounded")
        print(response.json())

asyncio.run(main())

Payment Flow

  1. Send a normal request to the endpoint (no API key needed)
  2. Server returns 402 Payment Required with payment details
  3. The x402 SDK automatically signs a payment authorization with your wallet
  4. The SDK resubmits the request with the signed payment
  5. Server verifies payment and returns the API response

The x402 SDK handles steps 2–5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request

Related Endpoints

  • /api/v1/solana/token-transactions - Retrieve a paginated list of trades/transactions for a specified Solana token address across all DEXes
  • /api/v1/solana/token-mint-burn-transactions - Returns paginated list of mint and burn transactions for a specified Solana token
  • /api/v1/solana/pool-transactions-time-bounded - Get detailed transaction data for any SPL token across major Solana DEXs with precise Unix timestamp filtering
  • /api/v1/solana/ohlcv/token - Retrieve Open, High, Low, Close, and Volume data for any SPL token
  • /api/v1/solana/tokens/security - Provides comprehensive security analysis for a token on Solana, including ownership concentration and transaction metrics