Skip to content

Commit 690415d

Browse files
authored
- added more dexes on FAQ correspond to supported chains (TBD) (#1085)
* - added dexes on FAQ correspond to supported chains (TBD) * -sorted new dexes based on volume * added -Address field semantics on FAQ
1 parent 9a72f46 commit 690415d

1 file changed

Lines changed: 48 additions & 4 deletions

File tree

  • website/src/pages/en/token-api

website/src/pages/en/token-api/faq.mdx

Lines changed: 48 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,7 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
135135
- Uniswap V4
136136
- SushiSwap V2
137137
- Balancer
138+
- Cow
138139
- Curve
139140
- Bancor
140141
- Ring Swap
@@ -143,6 +144,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
143144
- PancakeSwap V2
144145
- Solidly V3
145146
- SushiSwap V3
147+
- KyberSwap Elastic
148+
- Dodo
149+
- WOOFi
146150
- Fraxswap V2
147151
- Verse Exchange
148152
- Integral
@@ -166,6 +170,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
166170
- Balancer
167171
- Curve
168172
- Ramses
173+
- KyberSwap Elastic
174+
- WOOFi
175+
- Dodo
169176
- SushiSwap V2
170177
- Uniswap V2
171178
- Camelot
@@ -178,7 +185,7 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
178185
- DXswap
179186
- Arbidex
180187
- Integral
181-
- Trader Joe
188+
- Cow
182189

183190
#### Polygon Mainnet
184191

@@ -191,6 +198,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
191198
- Curve
192199
- Stabl.fi
193200
- SushiSwap V3
201+
- KyberSwap Elastic
202+
- Dodo
203+
- WOOFi
194204
- SweepnFlip
195205
- ApeSwap V2
196206
- DFYN
@@ -199,12 +209,14 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
199209
- Wault Finance
200210
- DooarSwap
201211
- Elk
212+
- Cow
202213

203214
#### Unichain Mainnet
204215

205216
- Uniswap V4
206217
- Uniswap V3
207218
- Uniswap V2
219+
- KyberSwap Elastic
208220

209221
#### BSC Mainnet
210222

@@ -213,6 +225,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
213225
- PancakeSwap V4
214226
- PancakeSwap V1
215227
- Biswap
228+
- Dodo
229+
- WOOFi
230+
- KyberSwap Elastic
216231
- ApeSwap V2
217232
- MDEX
218233
- BabySwap
@@ -222,7 +237,9 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
222237
- Algebra (v3-style)
223238
- WaultSwap
224239
- BakerySwap
240+
- LFJ (Trader Joe)
225241
- SquadSwap
242+
- Cow
226243

227244
#### Optimism Mainnet
228245

@@ -233,14 +250,16 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
233250
- Balancer
234251
- Curve
235252
- Beethoven X
253+
- KyberSwap Elastic
254+
- WOOFi
255+
- Dodo
236256

237257
#### Avalanche C-Chain
238258

239-
- Trader Joe V2.1
240-
- Trader Joe V3
241-
- Trader Joe V2
259+
- LFJ (Trader Joe)
242260
- Pangolin V2
243261
- Pangolin V1
262+
- KyberSwap Elastic
244263
- Elk Finance
245264
- Uniswap V4
246265
- Lydia Finance
@@ -253,8 +272,10 @@ Swaps are being reported via Aggregator programs and do not include amm_pool fie
253272
- Uniswap V3
254273
- Uniswap V2
255274
- Uniswap V4
275+
- Aerodrome
256276
- SushiSwap V2
257277
- Balancer
278+
- KyberSwap Elastic
258279
- Curve
259280
- BaseSwap
260281
- Alien Base V3
@@ -371,6 +392,29 @@ For EVM addresses, the API accepts hex addresses with either 42 or 40 characters
371392

372393
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.
373394

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+
374418
### Do I need special headers besides authentication?
375419

376420
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

Comments
 (0)