Skip to main content
GET
/
v1
/
pool
/
{blockchain}
/
by-token
/
{address}
Returns list of pools associated with given token
curl --request GET \
  --url https://backend.swap.coffee/v1/pool/{blockchain}/by-token/{address} \
  --header 'X-Api-Key: <api-key>'
[
  {
    "dex": "stonfi",
    "address": "<string>",
    "type": "public",
    "amm_type": "constant_product",
    "tokens": [
      "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs"
    ],
    "reserves": [
      123
    ],
    "fees": {
      "average_gas": 123,
      "divider": 123,
      "input": 123,
      "output": 123,
      "first_token": 123,
      "second_token": 123
    },
    "amm_settings": {},
    "restrictions": [
      {
        "min_swap_amount": 123,
        "max_swap_amount": 123
      }
    ],
    "unavailable_until": 123
  }
]

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
blockchain
string
required
Example:

"ton"

​
address
string
required
Example:

"EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs"

Query Parameters

​
dexes
string[]
​
size
integer<int32>
default:10
Required range: 1 <= x <= 100
​
page
integer<int32>
default:1
Required range: x >= 1

Response

list of pools

​
dex
string
required
Example:

"stonfi"

​
address
string
required
​
type
enum<string>
required
Available options:
public,
private,
slumbering,
invalid
​
amm_type
enum<string>
required
Available options:
constant_product,
cubic_stable,
curve_fi_stable,
concentrated_v3,
tonstakers,
weighted_constant_product,
weighted_stable,
bidask
​
tokens
string[]
required
​
reserves
number<double>[]
required
​
fees
object
required
​
amm_settings
object
​
restrictions
object[]
​
unavailable_until
integer<int64>

UTC unix timestamp in seconds