DexTrending DexTrendingDocs
Main site Open panel

API for developers

Packages endpoint

GET /packages returns every package on the account with its state. Available ones can be launched.

GET https://www.dextrending.net/api/v1/packages

Returns every package ever credited to the account, newest first. There is no pagination; accounts do not accumulate enough packages to need it.

Response

{
  "packages": [
    {
      "credit_id": 20,
      "package_id": "sol-24h",
      "package": "24 Hour Window",
      "hours": 24,
      "chain_group": "solana",
      "status": "available",
      "order_id": null,
      "bought_at": "2026-08-21T15:18:05+00:00",
      "used_at": null
    }
  ],
  "count": 1
}

Fields

FieldTypeNotes
credit_idintegerThe identifier you pass to POST /campaigns
package_idstringevm-12h, evm-24h, sol-12h or sol-24h
packagestringHuman-readable name, for example 24 Hour Window
hoursintegerHours on the trending list: 12 or 24
chain_groupstringsolana or evm. The campaign chain must match this.
statusstringavailable or used
order_idinteger or nullThe campaign that consumed it, once used
bought_atstringISO 8601 UTC
used_atstring or nullISO 8601 UTC, set when launched

Picking one to launch

Filter on status and match chain_group against the chain you intend to run on. Launching a Solana package against an EVM pair returns a 400 without consuming it, but checking first is cleaner.

const { packages } = await dt("/packages");

const ready = packages.find(
  p => p.status === "available" && p.chain_group === "solana"
);

if (!ready) throw new Error("No Solana package left");

Notes

  • Packages never expire, so available stays available indefinitely.
  • count is the total returned, not a page size.
  • Packages appear here the moment a payment confirms, which can be before you reload the panel.

Questions

How do I find a package I can launch?
Filter the list for status "available" and a chain_group that matches the chain you want to run on.
Do packages expire?
No. An available package stays available until you spend it.
Is the list paginated?
No. Accounts do not hold enough packages for pagination to be useful, so the full list is returned.