Skip to main content
POST
/
v1
/
jettons
getJettons
curl --request POST \
  --url https://api.dyor.io/v1/jettons \
  --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"
}
'
{
  "jettons": [
    {
      "metadata": {
        "address": "0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1",
        "name": "DYOR Coin",
        "symbol": "DYOR",
        "decimals": 15,
        "image": "https://storage.dyor.io/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/image.png",
        "description": "DYOR Coin is the utility token by DYOR.io, the biggest analytics platform on TON Blockchain.",
        "offchainImage": "https://storage.dyor.io/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/image.png",
        "offchainDescription": "DYOR Coin is the utility token by DYOR.io, the biggest analytics platform on TON Blockchain.",
        "links": [
          {
            "name": "Chat EN",
            "url": "https://t.me/DYORchatEN",
            "type": "LINK_TYPE_UNSPECIFIED"
          }
        ],
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "admin": {
        "address": "0:0000000000000000000000000000000000000000000000000000000000000000",
        "offchainAddress": "<string>"
      },
      "totalSupply": "299999852059244670506",
      "mintable": true,
      "modifiedContract": true,
      "verification": "JVS_NONE",
      "price": {
        "value": "1000500000",
        "decimals": 9
      },
      "priceUsd": {
        "value": "1000500000",
        "decimals": 9
      },
      "holdersCount": "7351",
      "liquidityUsd": {
        "value": "1000500000",
        "decimals": 9
      },
      "fdmc": {
        "value": "1000500000",
        "decimals": 9
      },
      "trustScore": 100,
      "mcap": {
        "value": "1000500000",
        "decimals": 9
      },
      "circulatingSupply": "<string>",
      "chartPreviews": [
        {
          "url": "<string>",
          "metric": "price",
          "period": "month",
          "color": "dark"
        }
      ]
    }
  ],
  "addressBook": {},
  "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.

​
jettons
List of jettons · object[]
​
addressBook
Possible aliases for all raw addresses in response · object
​
next
string

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