List Pools (Orca)
Retrieves a list of all Orca pools registered in the backend database (`orca_pool_registry_target`). It provides essential static information about each pool, including the token pair, decimals, tick spacing, and vault addresses.
GET
https://api.cambrian.org/solana/orca/pools
Parameters
dex* (string)
The Decentralized Exchange (DEX) name. Must be 'orca' for this endpoint.
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": "poolAddress",
"type": "String"
},
{
"name": "createdAt",
"type": "DateTime('UTC')"
},
{
"name": "token0Address",
"type": "String"
},
{
"name": "token0Symbol",
"type": "String"
},
{
"name": "token0Decimals",
"type": "UInt8"
},
{
"name": "token1Address",
"type": "String"
},
{
"name": "token1Symbol",
"type": "String"
},
{
"name": "token1Decimals",
"type": "UInt8"
},
{
"name": "tickSpacing",
"type": "Int32"
},
{
"name": "tokenVaultA",
"type": "String"
},
{
"name": "tokenVaultB",
"type": "String"
}
],
"data": [
[
"122FD4qsy8zkKqW9J2cZmjTN9hPjP8aE6D2GowFURr71",
"2024-04-19T12:30:25+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"7XhEZLWYfJmShx3f2gJTTwFvWFmbgVpZHAp2fozqUg8E",
"FONG",
9,
2,
"2W6e7m3FKUEKVyuWa86GNgVRbjKAqypQSmXxW7HWTQm3",
"DsFL1aHUWBUedEXcNfV8BzLmi94GYw6VxSkdWTGNZerc"
],
[
"126kcp6vLs176v9DkU2q1iBy5jUEMGZRzxpkJeQdcmDo",
"2026-07-21T09:21:40+00:00",
"BetPYFm1iEEPNsYeBXQiCae3cKALa9a1RnEK6bniBMDv",
"Ash",
9,
"Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"USDT",
6,
32896,
"2y1rKeq4p1UbTdCC8ZEuUebmkDFKs7i7YqAXfcQFENYh",
"8UHpHM4McFNMxgLqEXQ2uCyzSJTvPY959826uSFQ25iN"
],
[
"12BgjwjLMbodFq3gCYW9cMeyRy9z3eL86kcQ7PiPfUyb",
"2024-03-12T22:24:39+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"4fvS25Zyq9di8VgQtH4o8MrNzDnKuma3Z8fTgwXd1VMx",
"OPPY",
6,
128,
"36q2sHd31tPYuL8Yhm3wYMwX5cEBpHJYbhhZ5i5TLJjT",
"7tN6zCdNotfmpY2mKDhgMLVibKvbbyUqcLsjvvqbvotw"
],
[
"12SgZ1auKJgtyLXgW4Nc5wVzstVStfoQxe6ZXFi5gb3W",
"2024-05-13T08:55:47+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"AXNg5aNK3jkJCiMn5Av6yCRrULfwFjvHCBxC27KESxma",
"Hello",
6,
1,
"GNFjDNoQrGZSZS77KZKicrdnc6Wn5H1hAFFqdWTcdGeq",
"E8YBCrGfFVXEwam9wEAJMvd49eCGKHtewDmK6xnMWZnE"
],
[
"12aGZp2Q3TaPMouLXGYVZWKUUJdCth2wxS1NVMDRFj8k",
"2024-06-02T23:14:05+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"7gbEP2TAy5wM3TmMp5utCrRvdJ3FFqYjgN5KDpXiWPmo",
"DEVIN",
6,
128,
"ATZpzBQPdMpPnwXhWxJJU4ALWVLFjJAc4zwzAk8kazmr",
"DoyucsR2wV9U8UZMcDJikZ5JFY2R3aXvdnLG8M34mzwB"
],
[
"12bDxpetQ7E1NCn2HQzby2eX6tUYaBFwBh2X5RL4XkBA",
"2024-05-11T04:26:25+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"7RoVuYRxfBeH9fwHrx8LeLte4uJLBM52UmF4nyh4tNiQ",
"$smiski",
6,
128,
"513tz7Vu847pd4EbezPmMN8uPy4WdgTSMXefvmBF4T7o",
"H9u5JGqqcijw3vtka9Fz3mTSwRBs2CsAmWe8TxtanjcT"
],
[
"12eDHn6LTCP78UuhLb3fHRhEnHDoJzccLoixdefkFNtf",
"2024-02-26T15:20:01+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"D8c8hnr9rWgJZX9QntWHTpw8gkreW24MzLCGbBiHg2JK",
"SNOOPY",
9,
1,
"7fWfS68VrJoMaqf2VnfWC6Frr4MVQ6oVkc5PSrPr5pR",
"5MRdJQXH4MD2527faFJ894Mz1m5rwdmTrcQwHNAhszST"
],
[
"12k7ovnF5gSre7eVtWtz8tqKBRGdJdipYqGLM3aHfpsN",
"2024-03-16T12:57:58+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"c2sFwnTrVYbjM4ku6TgNk5Egavmh8GEQaLaWMsbUH7h",
"JIJIDoge",
2,
256,
"CBzgMGgvNfuMqivRtMtkHPmUUnWu2Zh1oN8nwsMJgCza",
"41rLTh8ZJrZCuWw2XHwS7HZzddAb6L38X1BGkoxjwJZX"
],
[
"12mFQfKgHknzDZTNPPGxpLcWRYh9hjUpYC1hPiWdvFwz",
"2024-01-31T16:01:28+00:00",
"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
"JUP",
6,
"JxxWsvm9jHt4ah7DT9NuLyVLYZcZLUdPD93PcPQ71Ka",
"mockJUP",
9,
256,
"FFhGPFyH3ZCeYX8moDwcqJib1Q17sXVWWzmoa7fBKKvE",
"3QJRsTrPCFKHrtJ1irtt8JTwgK4RXcJBbRnrrRzkzebC"
],
[
"12xeYhezRrpc5fg1t8sUV1bZ94rS6gx8yHgKvB1FF1By",
"2024-06-12T04:30:22+00:00",
"So11111111111111111111111111111111111111112",
"SOL",
9,
"8vCzsdoss5g9naVRtuVD34jfSmLwM28ucWujrWyppump",
"FATHER",
6,
256,
"2QSTBtCpu9WJgNswWNoDt7ZxVHCqmNd4fHpQgRv2nkeA",
"GAcdA8A42QFZMLZCne9zNG48fVQCyF8hxKSj5o3MRT7B"
]
],
"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. List Orca Pools
Retrieve a list of Orca pools, limited to 10 results.
curl
curl -X GET "https://api.cambrian.org/solana/orca/pools?dex=orca&limit=10" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"
Response:
JSON
1[
2 {
3 "columns": [
4 {
5 "name": "poolAddress",
6 "type": "String"
7 },
8 {
9 "name": "createdAt",
10 "type": "DateTime('UTC')"
11 },
12 {
13 "name": "token0Address",
14 "type": "String"
15 },
16 {
17 "name": "token0Symbol",
18 "type": "String"
19 },
20 {
21 "name": "token0Decimals",
22 "type": "UInt8"
23 },
24 {
25 "name": "token1Address",
26 "type": "String"
27 },
28 {
29 "name": "token1Symbol",
30 "type": "String"
31 },
32 {
33 "name": "token1Decimals",
34 "type": "UInt8"
35 },
36 {
37 "name": "tickSpacing",
38 "type": "Int32"
39 },
40 {
41 "name": "tokenVaultA",
42 "type": "String"
43 },
44 {
45 "name": "tokenVaultB",
46 "type": "String"
47 }
48 ],
49 "data": [
50 [
51 "122FD4qsy8zkKqW9J2cZmjTN9hPjP8aE6D2GowFURr71",
52 "2024-04-19T12:30:25+00:00",
53 "So11111111111111111111111111111111111111112",
54 "SOL",
55 9,
56 "7XhEZLWYfJmShx3f2gJTTwFvWFmbgVpZHAp2fozqUg8E",
57 "FONG",
58 9,
59 2,
60 "2W6e7m3FKUEKVyuWa86GNgVRbjKAqypQSmXxW7HWTQm3",
61 "DsFL1aHUWBUedEXcNfV8BzLmi94GYw6VxSkdWTGNZerc"
62 ],
63 [
64 "126kcp6vLs176v9DkU2q1iBy5jUEMGZRzxpkJeQdcmDo",
65 "2026-07-21T09:21:40+00:00",
66 "BetPYFm1iEEPNsYeBXQiCae3cKALa9a1RnEK6bniBMDv",
67 "Ash",
68 9,
69 "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
70 "USDT",
71 6,
72 32896,
73 "2y1rKeq4p1UbTdCC8ZEuUebmkDFKs7i7YqAXfcQFENYh",
74 "8UHpHM4McFNMxgLqEXQ2uCyzSJTvPY959826uSFQ25iN"
75 ],
76 [
77 "12BgjwjLMbodFq3gCYW9cMeyRy9z3eL86kcQ7PiPfUyb",
78 "2024-03-12T22:24:39+00:00",
79 "So11111111111111111111111111111111111111112",
80 "SOL",
81 9,
82 "4fvS25Zyq9di8VgQtH4o8MrNzDnKuma3Z8fTgwXd1VMx",
83 "OPPY",
84 6,
85 128,
86 "36q2sHd31tPYuL8Yhm3wYMwX5cEBpHJYbhhZ5i5TLJjT",
87 "7tN6zCdNotfmpY2mKDhgMLVibKvbbyUqcLsjvvqbvotw"
88 ],
89 [
90 "12SgZ1auKJgtyLXgW4Nc5wVzstVStfoQxe6ZXFi5gb3W",
91 "2024-05-13T08:55:47+00:00",
92 "So11111111111111111111111111111111111111112",
93 "SOL",
94 9,
95 "AXNg5aNK3jkJCiMn5Av6yCRrULfwFjvHCBxC27KESxma",
96 "Hello",
97 6,
98 1,
99 "GNFjDNoQrGZSZS77KZKicrdnc6Wn5H1hAFFqdWTcdGeq",
100 "E8YBCrGfFVXEwam9wEAJMvd49eCGKHtewDmK6xnMWZnE"
101 ],
102 [
103 "12aGZp2Q3TaPMouLXGYVZWKUUJdCth2wxS1NVMDRFj8k",
104 "2024-06-02T23:14:05+00:00",
105 "So11111111111111111111111111111111111111112",
106 "SOL",
107 9,
108 "7gbEP2TAy5wM3TmMp5utCrRvdJ3FFqYjgN5KDpXiWPmo",
109 "DEVIN",
110 6,
111 128,
112 "ATZpzBQPdMpPnwXhWxJJU4ALWVLFjJAc4zwzAk8kazmr",
113 "DoyucsR2wV9U8UZMcDJikZ5JFY2R3aXvdnLG8M34mzwB"
114 ],
115 [
116 "12bDxpetQ7E1NCn2HQzby2eX6tUYaBFwBh2X5RL4XkBA",
117 "2024-05-11T04:26:25+00:00",
118 "So11111111111111111111111111111111111111112",
119 "SOL",
120 9,
121 "7RoVuYRxfBeH9fwHrx8LeLte4uJLBM52UmF4nyh4tNiQ",
122 "$smiski",
123 6,
124 128,
125 "513tz7Vu847pd4EbezPmMN8uPy4WdgTSMXefvmBF4T7o",
126 "H9u5JGqqcijw3vtka9Fz3mTSwRBs2CsAmWe8TxtanjcT"
127 ],
128 [
129 "12eDHn6LTCP78UuhLb3fHRhEnHDoJzccLoixdefkFNtf",
130 "2024-02-26T15:20:01+00:00",
131 "So11111111111111111111111111111111111111112",
132 "SOL",
133 9,
134 "D8c8hnr9rWgJZX9QntWHTpw8gkreW24MzLCGbBiHg2JK",
135 "SNOOPY",
136 9,
137 1,
138 "7fWfS68VrJoMaqf2VnfWC6Frr4MVQ6oVkc5PSrPr5pR",
139 "5MRdJQXH4MD2527faFJ894Mz1m5rwdmTrcQwHNAhszST"
140 ],
141 [
142 "12k7ovnF5gSre7eVtWtz8tqKBRGdJdipYqGLM3aHfpsN",
143 "2024-03-16T12:57:58+00:00",
144 "So11111111111111111111111111111111111111112",
145 "SOL",
146 9,
147 "c2sFwnTrVYbjM4ku6TgNk5Egavmh8GEQaLaWMsbUH7h",
148 "JIJIDoge",
149 2,
150 256,
151 "CBzgMGgvNfuMqivRtMtkHPmUUnWu2Zh1oN8nwsMJgCza",
152 "41rLTh8ZJrZCuWw2XHwS7HZzddAb6L38X1BGkoxjwJZX"
153 ],
154 [
155 "12mFQfKgHknzDZTNPPGxpLcWRYh9hjUpYC1hPiWdvFwz",
156 "2024-01-31T16:01:28+00:00",
157 "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
158 "JUP",
159 6,
160 "JxxWsvm9jHt4ah7DT9NuLyVLYZcZLUdPD93PcPQ71Ka",
161 "mockJUP",
162 9,
163 256,
164 "FFhGPFyH3ZCeYX8moDwcqJib1Q17sXVWWzmoa7fBKKvE",
165 "3QJRsTrPCFKHrtJ1irtt8JTwgK4RXcJBbRnrrRzkzebC"
166 ],
167 [
168 "12xeYhezRrpc5fg1t8sUV1bZ94rS6gx8yHgKvB1FF1By",
169 "2024-06-12T04:30:22+00:00",
170 "So11111111111111111111111111111111111111112",
171 "SOL",
172 9,
173 "8vCzsdoss5g9naVRtuVD34jfSmLwM28ucWujrWyppump",
174 "FATHER",
175 6,
176 256,
177 "2QSTBtCpu9WJgNswWNoDt7ZxVHCqmNd4fHpQgRv2nkeA",
178 "GAcdA8A42QFZMLZCne9zNG48fVQCyF8hxKSj5o3MRT7B"
179 ]
180 ],
181 "rows": 10
182 }
183]
2 {
3 "columns": [
4 {
5 "name": "poolAddress",
6 "type": "String"
7 },
8 {
9 "name": "createdAt",
10 "type": "DateTime('UTC')"
11 },
12 {
13 "name": "token0Address",
14 "type": "String"
15 },
16 {
17 "name": "token0Symbol",
18 "type": "String"
19 },
20 {
21 "name": "token0Decimals",
22 "type": "UInt8"
23 },
24 {
25 "name": "token1Address",
26 "type": "String"
27 },
28 {
29 "name": "token1Symbol",
30 "type": "String"
31 },
32 {
33 "name": "token1Decimals",
34 "type": "UInt8"
35 },
36 {
37 "name": "tickSpacing",
38 "type": "Int32"
39 },
40 {
41 "name": "tokenVaultA",
42 "type": "String"
43 },
44 {
45 "name": "tokenVaultB",
46 "type": "String"
47 }
48 ],
49 "data": [
50 [
51 "122FD4qsy8zkKqW9J2cZmjTN9hPjP8aE6D2GowFURr71",
52 "2024-04-19T12:30:25+00:00",
53 "So11111111111111111111111111111111111111112",
54 "SOL",
55 9,
56 "7XhEZLWYfJmShx3f2gJTTwFvWFmbgVpZHAp2fozqUg8E",
57 "FONG",
58 9,
59 2,
60 "2W6e7m3FKUEKVyuWa86GNgVRbjKAqypQSmXxW7HWTQm3",
61 "DsFL1aHUWBUedEXcNfV8BzLmi94GYw6VxSkdWTGNZerc"
62 ],
63 [
64 "126kcp6vLs176v9DkU2q1iBy5jUEMGZRzxpkJeQdcmDo",
65 "2026-07-21T09:21:40+00:00",
66 "BetPYFm1iEEPNsYeBXQiCae3cKALa9a1RnEK6bniBMDv",
67 "Ash",
68 9,
69 "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
70 "USDT",
71 6,
72 32896,
73 "2y1rKeq4p1UbTdCC8ZEuUebmkDFKs7i7YqAXfcQFENYh",
74 "8UHpHM4McFNMxgLqEXQ2uCyzSJTvPY959826uSFQ25iN"
75 ],
76 [
77 "12BgjwjLMbodFq3gCYW9cMeyRy9z3eL86kcQ7PiPfUyb",
78 "2024-03-12T22:24:39+00:00",
79 "So11111111111111111111111111111111111111112",
80 "SOL",
81 9,
82 "4fvS25Zyq9di8VgQtH4o8MrNzDnKuma3Z8fTgwXd1VMx",
83 "OPPY",
84 6,
85 128,
86 "36q2sHd31tPYuL8Yhm3wYMwX5cEBpHJYbhhZ5i5TLJjT",
87 "7tN6zCdNotfmpY2mKDhgMLVibKvbbyUqcLsjvvqbvotw"
88 ],
89 [
90 "12SgZ1auKJgtyLXgW4Nc5wVzstVStfoQxe6ZXFi5gb3W",
91 "2024-05-13T08:55:47+00:00",
92 "So11111111111111111111111111111111111111112",
93 "SOL",
94 9,
95 "AXNg5aNK3jkJCiMn5Av6yCRrULfwFjvHCBxC27KESxma",
96 "Hello",
97 6,
98 1,
99 "GNFjDNoQrGZSZS77KZKicrdnc6Wn5H1hAFFqdWTcdGeq",
100 "E8YBCrGfFVXEwam9wEAJMvd49eCGKHtewDmK6xnMWZnE"
101 ],
102 [
103 "12aGZp2Q3TaPMouLXGYVZWKUUJdCth2wxS1NVMDRFj8k",
104 "2024-06-02T23:14:05+00:00",
105 "So11111111111111111111111111111111111111112",
106 "SOL",
107 9,
108 "7gbEP2TAy5wM3TmMp5utCrRvdJ3FFqYjgN5KDpXiWPmo",
109 "DEVIN",
110 6,
111 128,
112 "ATZpzBQPdMpPnwXhWxJJU4ALWVLFjJAc4zwzAk8kazmr",
113 "DoyucsR2wV9U8UZMcDJikZ5JFY2R3aXvdnLG8M34mzwB"
114 ],
115 [
116 "12bDxpetQ7E1NCn2HQzby2eX6tUYaBFwBh2X5RL4XkBA",
117 "2024-05-11T04:26:25+00:00",
118 "So11111111111111111111111111111111111111112",
119 "SOL",
120 9,
121 "7RoVuYRxfBeH9fwHrx8LeLte4uJLBM52UmF4nyh4tNiQ",
122 "$smiski",
123 6,
124 128,
125 "513tz7Vu847pd4EbezPmMN8uPy4WdgTSMXefvmBF4T7o",
126 "H9u5JGqqcijw3vtka9Fz3mTSwRBs2CsAmWe8TxtanjcT"
127 ],
128 [
129 "12eDHn6LTCP78UuhLb3fHRhEnHDoJzccLoixdefkFNtf",
130 "2024-02-26T15:20:01+00:00",
131 "So11111111111111111111111111111111111111112",
132 "SOL",
133 9,
134 "D8c8hnr9rWgJZX9QntWHTpw8gkreW24MzLCGbBiHg2JK",
135 "SNOOPY",
136 9,
137 1,
138 "7fWfS68VrJoMaqf2VnfWC6Frr4MVQ6oVkc5PSrPr5pR",
139 "5MRdJQXH4MD2527faFJ894Mz1m5rwdmTrcQwHNAhszST"
140 ],
141 [
142 "12k7ovnF5gSre7eVtWtz8tqKBRGdJdipYqGLM3aHfpsN",
143 "2024-03-16T12:57:58+00:00",
144 "So11111111111111111111111111111111111111112",
145 "SOL",
146 9,
147 "c2sFwnTrVYbjM4ku6TgNk5Egavmh8GEQaLaWMsbUH7h",
148 "JIJIDoge",
149 2,
150 256,
151 "CBzgMGgvNfuMqivRtMtkHPmUUnWu2Zh1oN8nwsMJgCza",
152 "41rLTh8ZJrZCuWw2XHwS7HZzddAb6L38X1BGkoxjwJZX"
153 ],
154 [
155 "12mFQfKgHknzDZTNPPGxpLcWRYh9hjUpYC1hPiWdvFwz",
156 "2024-01-31T16:01:28+00:00",
157 "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
158 "JUP",
159 6,
160 "JxxWsvm9jHt4ah7DT9NuLyVLYZcZLUdPD93PcPQ71Ka",
161 "mockJUP",
162 9,
163 256,
164 "FFhGPFyH3ZCeYX8moDwcqJib1Q17sXVWWzmoa7fBKKvE",
165 "3QJRsTrPCFKHrtJ1irtt8JTwgK4RXcJBbRnrrRzkzebC"
166 ],
167 [
168 "12xeYhezRrpc5fg1t8sUV1bZ94rS6gx8yHgKvB1FF1By",
169 "2024-06-12T04:30:22+00:00",
170 "So11111111111111111111111111111111111111112",
171 "SOL",
172 9,
173 "8vCzsdoss5g9naVRtuVD34jfSmLwM28ucWujrWyppump",
174 "FATHER",
175 6,
176 256,
177 "2QSTBtCpu9WJgNswWNoDt7ZxVHCqmNd4fHpQgRv2nkeA",
178 "GAcdA8A42QFZMLZCne9zNG48fVQCyF8hxKSj5o3MRT7B"
179 ]
180 ],
181 "rows": 10
182 }
183]
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/orca/pools"
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/orca/pools"
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/orca/pools")
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/orca/pools")
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