You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/src/pages/en/token-api/faq.mdx
+48-4Lines changed: 48 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -135,6 +135,7 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
135
135
- Uniswap V4
136
136
- SushiSwap V2
137
137
- Balancer
138
+
- Cow
138
139
- Curve
139
140
- Bancor
140
141
- Ring Swap
@@ -143,6 +144,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
143
144
- PancakeSwap V2
144
145
- Solidly V3
145
146
- SushiSwap V3
147
+
- KyberSwap Elastic
148
+
- Dodo
149
+
- WOOFi
146
150
- Fraxswap V2
147
151
- Verse Exchange
148
152
- Integral
@@ -166,6 +170,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
166
170
- Balancer
167
171
- Curve
168
172
- Ramses
173
+
- KyberSwap Elastic
174
+
- WOOFi
175
+
- Dodo
169
176
- SushiSwap V2
170
177
- Uniswap V2
171
178
- Camelot
@@ -178,7 +185,7 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
178
185
- DXswap
179
186
- Arbidex
180
187
- Integral
181
-
-Trader Joe
188
+
-Cow
182
189
183
190
#### Polygon Mainnet
184
191
@@ -191,6 +198,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
191
198
- Curve
192
199
- Stabl.fi
193
200
- SushiSwap V3
201
+
- KyberSwap Elastic
202
+
- Dodo
203
+
- WOOFi
194
204
- SweepnFlip
195
205
- ApeSwap V2
196
206
- DFYN
@@ -199,12 +209,14 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
199
209
- Wault Finance
200
210
- DooarSwap
201
211
- Elk
212
+
- Cow
202
213
203
214
#### Unichain Mainnet
204
215
205
216
- Uniswap V4
206
217
- Uniswap V3
207
218
- Uniswap V2
219
+
- KyberSwap Elastic
208
220
209
221
#### BSC Mainnet
210
222
@@ -213,6 +225,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
213
225
- PancakeSwap V4
214
226
- PancakeSwap V1
215
227
- Biswap
228
+
- Dodo
229
+
- WOOFi
230
+
- KyberSwap Elastic
216
231
- ApeSwap V2
217
232
- MDEX
218
233
- BabySwap
@@ -222,7 +237,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
222
237
- Algebra (v3-style)
223
238
- WaultSwap
224
239
- BakerySwap
240
+
- LFJ (Trader Joe)
225
241
- SquadSwap
242
+
- Cow
226
243
227
244
#### Optimism Mainnet
228
245
@@ -233,14 +250,16 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
233
250
- Balancer
234
251
- Curve
235
252
- Beethoven X
253
+
- KyberSwap Elastic
254
+
- WOOFi
255
+
- Dodo
236
256
237
257
#### Avalanche C-Chain
238
258
239
-
- Trader Joe V2.1
240
-
- Trader Joe V3
241
-
- Trader Joe V2
259
+
- LFJ (Trader Joe)
242
260
- Pangolin V2
243
261
- Pangolin V1
262
+
- KyberSwap Elastic
244
263
- Elk Finance
245
264
- Uniswap V4
246
265
- Lydia Finance
@@ -253,8 +272,10 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
253
272
- Uniswap V3
254
273
- Uniswap V2
255
274
- Uniswap V4
275
+
- Aerodrome
256
276
- SushiSwap V2
257
277
- Balancer
278
+
- KyberSwap Elastic
258
279
- Curve
259
280
- BaseSwap
260
281
- Alien Base V3
@@ -371,6 +392,29 @@ For EVM addresses, the API accepts hex addresses with either 42 or 40 characters
371
392
372
393
SVM addresses are base58-encoded strings that are typically 32-44 characters long. They contain a mix of uppercase letters, lowercase letters, and numbers. Unlike Ethereum Mainnet addresses which are hexadecimal and start with "0x", Solana Mainnet addresses don't have a consistent prefix pattern.
373
394
395
+
### Address field semantics
396
+
397
+
Swap-related address fields are DEX-dependent and should not be treated as interchangeable.
398
+
399
+
The API exposes:
400
+
401
+
-`transaction_from` — the account that initiated the transaction onchain
402
+
-`caller` — the account or contract that called the swap-relevant smart contract
403
+
-`sender` — a field that, in many modern DEX integrations, is best interpreted as the end-user side of the swap flow
404
+
-`recipient` — the swap recipient field when available from protocol data
405
+
406
+
These fields may be the same in some protocols and different in others. For example, simpler Uniswap V2-style flows can be more direct, while Uniswap V3 and newer routed designs often involve routers or intermediary contracts, so the contract-level caller may differ from the wallet that initiated the transaction.
407
+
408
+
The `sender` field deserves special attention. Although the field is named `sender`, in many modern DEX designs it more closely represents the user associated with the swap than a strict low-level transfer sender. This is because many protocols now route swaps through intermediary contracts, and those routers may handle both the send and receive side of token movement before funds reach the final user. In practice, `sender` is often best understood as a user-oriented field rather than a literal transfer sender across all DEX implementations.
409
+
410
+
Because of this:
411
+
412
+
-`transaction_from`, `caller`, `sender`, and `recipient` may all differ
413
+
-`caller` should not be interpreted as the same as `transaction_from`
414
+
-`sender` is often the most user-oriented address in the response, but its exact semantics still depend on the DEX implementation
415
+
-`recipient` may refer to an intermediate contract rather than the final wallet beneficiary
416
+
- TVM swap data does not include call data, which is why `caller` is not supported there
417
+
374
418
### Do I need special headers besides authentication?
375
419
376
420
While recommended, `Accept: application/json` isn't strictly required as the API returns JSON by default. The critical header is `Authorization: Bearer <token>`. Ensure you make a GET request to the correct URL without trailing slashes or path typos (e.g., use `/v1/evm/balances` not `/v1/evm/balance`).
0 commit comments