Tokens API

Who locked this token or LP token, how much, and until when?

Each time lock one locker protocol holds on a token or LP token: owner, amount locked and withdrawn, lock and unlock time, and whether it is permanent. One locker only.

GET/api/external/token-analysis/token-locks/{chain}/{mint}

Get a free API key Try it in the API reference

What it returns

The individual time locks one token-locker protocol holds on this token or LP token: who can withdraw each, how much is locked and already withdrawn (raw base units — divide by the token's decimals), when it was locked and when it ends, and whether it never ends. Covers ONE locker protocol only: an empty list means that locker holds nothing on the token, not that the liquidity is unlocked — other lockers and burned LP are not counted here; for the share of LP locked or burned across lockers use lp-safety. At most the first 100 locks are listed; totalLocks counts them all. An unlocksAt in the past means the lock has ended, and its amount can be withdrawn by its owner.

Chains

BNB Chain BNB
Ethereum ETH
Base BASE
Robinhood Chain RHC

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/token-analysis/token-locks/BNB/<mint>"

Parameters
Parameter	Description
`chain` path · string · required	The chain the token lives on. ETH, BNB, BASE and RHC are served; SOL, STABLE and ARC return 400. CELO, ARB, OP and SCROLL return 400 here.
`mint` path · string · required	The token mint address (Solana) or contract address (EVM).

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Who locked this token or LP token, how much, and until when?
Field	Type	Description
`token`	string	The token, lowercase.
`totalLocks`	integer	Locks held on the token in total. Larger than the list only past 100 locks.
`locks`	object[]	The first 100 locks, oldest lock first. Empty when this locker holds none on the token.
`locks[].lockId`	string	The locker's id for the lock, a decimal string.
`locks[].owner`	string \| null	Who can withdraw the lock when it ends, lowercase.
`locks[].lpToken`	boolean \| null	Whether the locked token is an LP token. `null` when it could not be told.
`locks[].amount`	string \| null	The amount locked, in the token's raw base units, as a decimal string.
`locks[].withdrawn`	string \| null	The amount already withdrawn from the lock, raw base units, as a decimal string. `"0"` on an ended lock means nothing has been taken out yet.
`locks[].lockedAt`	integer \| null	When the lock was made, unix seconds.
`locks[].unlocksAt`	integer \| null	When the lock ends, unix seconds. A permanent lock carries 253370764800 (year 9999).
`locks[].permanent`	boolean \| null	Whether the lock never ends.

Price per call

BNB Chain, Ethereum, Base, Robinhood Chain: 40,161 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

Is the liquidity locked or burned
The share of LP locked or burned across every locker, where this lists one locker lock by lock.
Which concentrated-liquidity LP positions are locked, by whom and until when?
The same kind of lock on fungible and v2 LP tokens, looked up by token.
Who holds a Solana token in ZK-compressed form
The wallets holding one Solana mint as ZK-compressed tokens, with each raw compressed balance, a page at a time. Ordinary token accounts of the mint are not included.
Which insiders, bundlers, snipers, devs, smart traders and KOLs hold this token?
Labelled wallets holding a token (insider, bundler, sniper, dev, smart trader, KOL), largest first: balance, supply share, buys/sells, USD in/out, avg buy price, profit. SOL only.
Seven-day price sparklines for many tokens
The last seven days of USD prices for up to 25 tokens on one chain, one point per 4-hour bucket, in one request — the small chart beside each row of a watch list or a token table.
How much of the token's supply have its insiders held, over time?
The share of supply held by the wallets tagged as insiders, as a time series of change points; shows whether insiders are accumulating or selling out. Solana only.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key