Token Transaction Feed (Time Bounded)
Get detailed transaction data for any SPL token with precise Unix timestamp filtering for historical analysis and event-driven research. This endpoint returns individual buy/sell transactions across major Solana DEXs within a specified time window, including trade size, USD value, and pool/DEX details.
GET
https://api.cambrian.org/solana/token-transactions-time-bounded
Parameters
token_address* (string)
Token program address (base58-44 string). See tokens for valid addresses.
after_time* (integer)
Unix timestamp - start time for data range
before_time* (integer)
Unix timestamp - end time for data range
limit (integer)
Limit the number of results.
offset (integer)
Offset the results, allows you to skip a number of rows before starting to return rows.
Responses
Code
Description
200
Successful response
Media type: application/vnd.cambrian.table.v1.0.0+json
[
{
"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": [
[
"4Dqa1fme5FfHC1iBJ9jUPVbRsDJ92SmSAyFP138R5ybUiX38UC9XVxB9ZKjmj7nXoo27PCc5Ew76SedE1e33cfVz",
311292616,
"buy",
0.074712157,
14.489356306005309,
193.9357246238428,
"Meteora",
"FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
],
[
"5NY1QG3qHqr333JHWgxnPVJsqgKdyHtcvybQLkpBmhft8jXtprBgXgR3KM1fbniBGcnanV1vdyzTQnDEDYMzohBW",
311292616,
"buy",
5.540280975,
1074.4584055063153,
193.9357246238428,
"Meteora",
"FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
],
[
"2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
311292616,
"sell",
11.344764636,
2200.1551503696064,
193.9357246238428,
"Raydium CLMM",
"EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
],
[
"2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
311292616,
"sell",
11.344764636,
2200.1551503696064,
193.9357246238428,
"Raydium CLMM",
"EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
],
[
"58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
311292616,
"sell",
11.319778006,
2195.309350174648,
193.9357246238428,
"Raydium CLMM",
"8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
],
[
"58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
311292616,
"sell",
11.319778006,
2195.309350174648,
193.9357246238428,
"Raydium CLMM",
"8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
],
[
"uakqqgxhd3P6YFwCoydaPYwmisBuze263ZUhrMQmhrpTyTbLxtkGCSf6pDn5R6aAa8bnEGxVFKfpfWvh8o1H89v",
311292615,
"buy",
0.000063539,
0.012322482006874347,
193.9357246238428,
"Meteora",
"BAn32AF4BZ9npV6ufFKq9JR85SiokJg9VDmHH1v1ZC6f"
],
[
"4bhbmYadFwcDm2KX9JuS33ZWUNF7UZqYmsngeb8JKji7vsD5uCExNaMSo48c55x5XzVbL84YY9z68JPaXPTQTLzy",
311292615,
"sell",
0.117894634,
22.863981274052733,
193.9357246238428,
"Meteora",
"7yhzz79wnrtxZ27RrsqxtHUFH69tWeQs8U4ptUdNGtyU"
],
[
"5Sv2ZpredmSBDyYgRuz43CbJgU3T9bKrg2ACJvc56ekg9qv9TqLnxSYpsayuxp4nZ5fpCwffVZZjFtVRJxfbaAeP",
311292615,
"sell",
0.167196515,
32.4253772911062,
193.9357246238428,
"Meteora",
"CZWD8zbzFwdjv13FJcCgHg2Ytyam9H2NsXVLZMeyYFCy"
],
[
"z4wKCXk1roenee5UgMMr6GSeiJZ9a7T9dMdQEZDi7Q1ayGLPuzUzoEkPeDRLTxLgBKeUqaBdAmLWh14RKMmv15X",
311292615,
"sell",
0.00067343,
0.13060213503343446,
193.9357246238428,
"Meteora",
"BTz3nMDswq6mTBMPFzkxacRR7gqo2VR7qsR2t9cR8eR6"
]
],
"rows": 10
}
]
400
Bad Request: Invalid request parameters or malformed request.
401
Unauthorized: Missing or invalid API key. Include X-API-Key header with your request.
403
Forbidden: Invalid API key or insufficient permissions to access this resource.
404
Not Found: Endpoint or resource does not exist.
408
Request Timeout: Request took too long to process. Try again.
500
Internal Server Error: An unexpected error occurred while processing your request.
503
Service Unavailable: The server is temporarily unable to handle the request. Please try again later.
Examples
1. Fetch Transactions Within a Fixed Time Window
Retrieve transaction data for SOL within a specific Unix timestamp range, limited to 10 results.
curl
curl -X GET "https://api.cambrian.org/solana/token-transactions-time-bounded?token_address=So11111111111111111111111111111111111111112&after_time=1735689600&before_time=1735776000&limit=10" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"
Response:
JSON
1[
2 {
3 "columns": [
4 {
5 "name": "signature",
6 "type": "String"
7 },
8 {
9 "name": "slot",
10 "type": "UInt64"
11 },
12 {
13 "name": "txType",
14 "type": "String"
15 },
16 {
17 "name": "tokenAmount",
18 "type": "Float64"
19 },
20 {
21 "name": "valueUSD",
22 "type": "Float64"
23 },
24 {
25 "name": "priceUSD",
26 "type": "Float64"
27 },
28 {
29 "name": "dex",
30 "type": "String"
31 },
32 {
33 "name": "poolAddress",
34 "type": "String"
35 }
36 ],
37 "data": [
38 [
39 "4Dqa1fme5FfHC1iBJ9jUPVbRsDJ92SmSAyFP138R5ybUiX38UC9XVxB9ZKjmj7nXoo27PCc5Ew76SedE1e33cfVz",
40 311292616,
41 "buy",
42 0.074712157,
43 14.489356306005309,
44 193.9357246238428,
45 "Meteora",
46 "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
47 ],
48 [
49 "5NY1QG3qHqr333JHWgxnPVJsqgKdyHtcvybQLkpBmhft8jXtprBgXgR3KM1fbniBGcnanV1vdyzTQnDEDYMzohBW",
50 311292616,
51 "buy",
52 5.540280975,
53 1074.4584055063153,
54 193.9357246238428,
55 "Meteora",
56 "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
57 ],
58 [
59 "2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
60 311292616,
61 "sell",
62 11.344764636,
63 2200.1551503696064,
64 193.9357246238428,
65 "Raydium CLMM",
66 "EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
67 ],
68 [
69 "2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
70 311292616,
71 "sell",
72 11.344764636,
73 2200.1551503696064,
74 193.9357246238428,
75 "Raydium CLMM",
76 "EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
77 ],
78 [
79 "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
80 311292616,
81 "sell",
82 11.319778006,
83 2195.309350174648,
84 193.9357246238428,
85 "Raydium CLMM",
86 "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
87 ],
88 [
89 "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
90 311292616,
91 "sell",
92 11.319778006,
93 2195.309350174648,
94 193.9357246238428,
95 "Raydium CLMM",
96 "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
97 ],
98 [
99 "uakqqgxhd3P6YFwCoydaPYwmisBuze263ZUhrMQmhrpTyTbLxtkGCSf6pDn5R6aAa8bnEGxVFKfpfWvh8o1H89v",
100 311292615,
101 "buy",
102 0.000063539,
103 0.012322482006874347,
104 193.9357246238428,
105 "Meteora",
106 "BAn32AF4BZ9npV6ufFKq9JR85SiokJg9VDmHH1v1ZC6f"
107 ],
108 [
109 "4bhbmYadFwcDm2KX9JuS33ZWUNF7UZqYmsngeb8JKji7vsD5uCExNaMSo48c55x5XzVbL84YY9z68JPaXPTQTLzy",
110 311292615,
111 "sell",
112 0.117894634,
113 22.863981274052733,
114 193.9357246238428,
115 "Meteora",
116 "7yhzz79wnrtxZ27RrsqxtHUFH69tWeQs8U4ptUdNGtyU"
117 ],
118 [
119 "5Sv2ZpredmSBDyYgRuz43CbJgU3T9bKrg2ACJvc56ekg9qv9TqLnxSYpsayuxp4nZ5fpCwffVZZjFtVRJxfbaAeP",
120 311292615,
121 "sell",
122 0.167196515,
123 32.4253772911062,
124 193.9357246238428,
125 "Meteora",
126 "CZWD8zbzFwdjv13FJcCgHg2Ytyam9H2NsXVLZMeyYFCy"
127 ],
128 [
129 "z4wKCXk1roenee5UgMMr6GSeiJZ9a7T9dMdQEZDi7Q1ayGLPuzUzoEkPeDRLTxLgBKeUqaBdAmLWh14RKMmv15X",
130 311292615,
131 "sell",
132 0.00067343,
133 0.13060213503343446,
134 193.9357246238428,
135 "Meteora",
136 "BTz3nMDswq6mTBMPFzkxacRR7gqo2VR7qsR2t9cR8eR6"
137 ]
138 ],
139 "rows": 10
140 }
141]
2 {
3 "columns": [
4 {
5 "name": "signature",
6 "type": "String"
7 },
8 {
9 "name": "slot",
10 "type": "UInt64"
11 },
12 {
13 "name": "txType",
14 "type": "String"
15 },
16 {
17 "name": "tokenAmount",
18 "type": "Float64"
19 },
20 {
21 "name": "valueUSD",
22 "type": "Float64"
23 },
24 {
25 "name": "priceUSD",
26 "type": "Float64"
27 },
28 {
29 "name": "dex",
30 "type": "String"
31 },
32 {
33 "name": "poolAddress",
34 "type": "String"
35 }
36 ],
37 "data": [
38 [
39 "4Dqa1fme5FfHC1iBJ9jUPVbRsDJ92SmSAyFP138R5ybUiX38UC9XVxB9ZKjmj7nXoo27PCc5Ew76SedE1e33cfVz",
40 311292616,
41 "buy",
42 0.074712157,
43 14.489356306005309,
44 193.9357246238428,
45 "Meteora",
46 "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
47 ],
48 [
49 "5NY1QG3qHqr333JHWgxnPVJsqgKdyHtcvybQLkpBmhft8jXtprBgXgR3KM1fbniBGcnanV1vdyzTQnDEDYMzohBW",
50 311292616,
51 "buy",
52 5.540280975,
53 1074.4584055063153,
54 193.9357246238428,
55 "Meteora",
56 "FqW6QxWG7kDHbQgZ9pxZR5rqXYJHd7ZHwUEcCugHFmSQ"
57 ],
58 [
59 "2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
60 311292616,
61 "sell",
62 11.344764636,
63 2200.1551503696064,
64 193.9357246238428,
65 "Raydium CLMM",
66 "EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
67 ],
68 [
69 "2BjnScg6rTGu3757nbPkqyM3gdr18CQHwC13foo4bTdKdqCNTrCvvNPRsqf8GYj4it45CZu3qEWzkJyUNFBHUxHq",
70 311292616,
71 "sell",
72 11.344764636,
73 2200.1551503696064,
74 193.9357246238428,
75 "Raydium CLMM",
76 "EtU7GUW6ogxke9gSjRFm8akgxwyuMT4Rm1mgbkEBTi34"
77 ],
78 [
79 "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
80 311292616,
81 "sell",
82 11.319778006,
83 2195.309350174648,
84 193.9357246238428,
85 "Raydium CLMM",
86 "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
87 ],
88 [
89 "58vRkVdv26UFFfsyH8x6SzrrsZvHnisLppetJFqGA8hirJsKxzN6JiXLmZkH41r9Q41cpmkBszLj9VJeVxgF7HDZ",
90 311292616,
91 "sell",
92 11.319778006,
93 2195.309350174648,
94 193.9357246238428,
95 "Raydium CLMM",
96 "8sN9549P3Zn6xpQRqpApN57xzkCh6sJxLwuEjcG2W4Ji"
97 ],
98 [
99 "uakqqgxhd3P6YFwCoydaPYwmisBuze263ZUhrMQmhrpTyTbLxtkGCSf6pDn5R6aAa8bnEGxVFKfpfWvh8o1H89v",
100 311292615,
101 "buy",
102 0.000063539,
103 0.012322482006874347,
104 193.9357246238428,
105 "Meteora",
106 "BAn32AF4BZ9npV6ufFKq9JR85SiokJg9VDmHH1v1ZC6f"
107 ],
108 [
109 "4bhbmYadFwcDm2KX9JuS33ZWUNF7UZqYmsngeb8JKji7vsD5uCExNaMSo48c55x5XzVbL84YY9z68JPaXPTQTLzy",
110 311292615,
111 "sell",
112 0.117894634,
113 22.863981274052733,
114 193.9357246238428,
115 "Meteora",
116 "7yhzz79wnrtxZ27RrsqxtHUFH69tWeQs8U4ptUdNGtyU"
117 ],
118 [
119 "5Sv2ZpredmSBDyYgRuz43CbJgU3T9bKrg2ACJvc56ekg9qv9TqLnxSYpsayuxp4nZ5fpCwffVZZjFtVRJxfbaAeP",
120 311292615,
121 "sell",
122 0.167196515,
123 32.4253772911062,
124 193.9357246238428,
125 "Meteora",
126 "CZWD8zbzFwdjv13FJcCgHg2Ytyam9H2NsXVLZMeyYFCy"
127 ],
128 [
129 "z4wKCXk1roenee5UgMMr6GSeiJZ9a7T9dMdQEZDi7Q1ayGLPuzUzoEkPeDRLTxLgBKeUqaBdAmLWh14RKMmv15X",
130 311292615,
131 "sell",
132 0.00067343,
133 0.13060213503343446,
134 193.9357246238428,
135 "Meteora",
136 "BTz3nMDswq6mTBMPFzkxacRR7gqo2VR7qsR2t9cR8eR6"
137 ]
138 ],
139 "rows": 10
140 }
141]
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.
Quickstart (Typescript)
bash
npm install @x402/fetch @x402/evm viem
TypeScript
1import { x402Client } from "@x402/core/client";
2import { ExactEvmScheme } from "@x402/evm/exact/client";
3import { wrapFetchWithPayment } from "@x402/fetch";
4import { privateKeyToAccount } from "viem/accounts";
5const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
6const client = new x402Client();
7client.register("eip155:*", new ExactEvmScheme(signer));
8const fetchWithPayment = wrapFetchWithPayment(fetch, client);
9const response = await fetchWithPayment(
10 "https://x402.cambrian.org/solana/token-transactions-time-bounded"
11);
12const data = await response.json();
2import { ExactEvmScheme } from "@x402/evm/exact/client";
3import { wrapFetchWithPayment } from "@x402/fetch";
4import { privateKeyToAccount } from "viem/accounts";
5const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
6const client = new x402Client();
7client.register("eip155:*", new ExactEvmScheme(signer));
8const fetchWithPayment = wrapFetchWithPayment(fetch, client);
9const response = await fetchWithPayment(
10 "https://x402.cambrian.org/solana/token-transactions-time-bounded"
11);
12const data = await response.json();
Quickstart (Python)
bash
pip install "x402[httpx]"
Python
1import asyncio, os
2from eth_account import Account
3from x402 import x402Client
4from x402.http.clients import x402HttpxClient
5from x402.mechanisms.evm import EthAccountSigner
6from x402.mechanisms.evm.exact.register import register_exact_evm_client
7async def main():
8 client = x402Client()
9 account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
10 register_exact_evm_client(client, EthAccountSigner(account))
11 async with x402HttpxClient(client) as http:
12 response = await http.get("https://x402.cambrian.org/solana/token-transactions-time-bounded")
13 print(response.json())
14asyncio.run(main())
2from eth_account import Account
3from x402 import x402Client
4from x402.http.clients import x402HttpxClient
5from x402.mechanisms.evm import EthAccountSigner
6from x402.mechanisms.evm.exact.register import register_exact_evm_client
7async def main():
8 client = x402Client()
9 account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
10 register_exact_evm_client(client, EthAccountSigner(account))
11 async with x402HttpxClient(client) as http:
12 response = await http.get("https://x402.cambrian.org/solana/token-transactions-time-bounded")
13 print(response.json())
14asyncio.run(main())
Payment Flow
- Send a normal request to the endpoint (no API key needed)
- Server returns 402 Payment Required with payment details
- The x402 SDK automatically signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- Server verifies payment and returns the API response
The x402 SDK handles steps 2 through 5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request