Skip to main content
POST
/
v1
/
jettons
/
metrics
getJettonMetricsList
curl --request POST \
  --url https://api.dyor.io/v1/jettons/metrics \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 123,
  "cursor": "<string>",
  "excludeScam": true,
  "search": "<string>",
  "address": [
    "<string>"
  ],
  "admin": [
    "<string>"
  ],
  "verification": [
    "JVS_NONE"
  ],
  "sort": "createdAt",
  "order": "asc",
  "priceChange": {
    "ton": {
      "hour": {
        "min": 123,
        "max": 123
      },
      "hour6": {
        "min": 123,
        "max": 123
      },
      "day": {
        "min": 123,
        "max": 123
      },
      "week": {
        "min": 123,
        "max": 123
      }
    }
  },
  "liquidity": {
    "usd": {
      "min": {
        "value": "<string>",
        "decimals": 123
      },
      "max": {
        "value": "<string>",
        "decimals": 123
      }
    }
  },
  "fdmc": {
    "min": {
      "value": "<string>",
      "decimals": 123
    },
    "max": {
      "value": "<string>",
      "decimals": 123
    }
  },
  "trustScore": {
    "min": "<string>",
    "max": "<string>"
  },
  "holders": {
    "min": "<string>",
    "max": "<string>"
  },
  "currency": "ton"
}
'
{
  "items": [
    {
      "address": "0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1",
      "price": {
        "value": "1000500000",
        "decimals": 9
      },
      "priceUsd": {
        "value": "1000500000",
        "decimals": 9
      },
      "priceCurrency": {
        "value": "1000500000",
        "decimals": 9
      },
      "holdersCount": "7351",
      "liquidityUsd": {
        "value": "1000500000",
        "decimals": 9
      },
      "liquidityCurrency": {
        "value": "1000500000",
        "decimals": 9
      },
      "fdmc": {
        "value": "1000500000",
        "decimals": 9
      },
      "fdmcCurrency": {
        "value": "1000500000",
        "decimals": 9
      },
      "mcap": {
        "value": "1000500000",
        "decimals": 9
      },
      "mcapCurrency": {
        "value": "1000500000",
        "decimals": 9
      },
      "circulatingSupply": "<string>",
      "trustScore": 100
    }
  ],
  "addressBook": {},
  "jettons": {},
  "next": "<string>"
}

Body

application/json
​
limit
integer<int64>

Max value: 100

​
cursor
string

Should be set by value from response field next

​
excludeScam
boolean

Jettons marked as scam will be excluded, if it's set to true

​
search
string

Search by phrase in jetton name or symbol Length should be in range [3:255]

​
address
string[]

Example: EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz Max count: 100

​
admin
string[]

Example: EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz Max count: 10

​
verification
enum<string>[]

Max count: 5

Available options:
JVS_NONE,
JVS_APPROVED,
JVS_COMMUNITY_VERIFIED,
JVS_VERIFIED,
JVS_SCAM
​
sort
enum<string>
default:createdAt
Available options:
createdAt,
fdmc,
tvl,
liquidityUsd,
trustScore,
volume24h,
holders,
traders24h,
transactions24h,
tonPriceChangeHour,
tonPriceChangeHour6,
tonPriceChangeDay,
tonPriceChangeWeek,
tonPriceChangeMonth
​
order
enum<string>
default:asc
Available options:
asc,
desc
​
priceChange
object
​
liquidity
object
​
fdmc
Filter in basic token units · object

Range [min, max]

​
trustScore
Filter in range [min, max] · object
​
holders
Filter in range [min, max] · object
​
currency
enum<string>
default:ton
Available options:
ton,
usd,
eur,
gbp,
jpy,
byn,
ves,
rub,
uah,
kzt,
krw,
ils,
idr,
aed,
gel,
twd,
try,
hkd,
inr,
cad,
amd,
aud,
pln,
cop,
brl,
chf,
mxn,
ars,
sgd,
sar,
mdl,
ron,
sek,
azn,
rsd,
nok,
myr,
bgn,
egp,
gtq,
clp,
nzd,
bdt,
kgs,
thb,
uzs,
uyu,
vnd,
ugx,
kes,
zar,
etb,
ngn,
lkr

Response

A successful response.

​
items
The list of jetton metrics · object[]
​
addressBook
Address book · object

Possible aliases for all raw addresses in response

​
jettons
Short metadata about jettons used in response · object
​
next
string

If the field is empty or not exists there's no next page