API for developers

Campaigns endpoint

List campaigns with live status and progress, or launch a package against a pair. Launching is irreversible.

GET /campaigns

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

Your campaigns, newest first, up to 100. Status and progress are recalculated on every request, so the values are current rather than cached.

{
  "campaigns": [
    {
      "order_no": "CMP-TK4LPJDC84",
      "package": "12 Hour Window",
      "chain": "solana",
      "token": {
        "address": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump",
        "symbol": "CATE",
        "name": "Catecoin",
        "logo_url": "https://cdn.dexscreener.com/cms/images/...",
        "pair_url": "https://dexscreener.com/solana/hmzvseemtzhhvznw9uwbag85hctmfnkbhzux16cy7ca3"
      },
      "hours": 12,
      "status": "running",
      "progress": 23,
      "seconds_remaining": 33167,
      "starts_at": "2026-08-21T15:29:43+00:00",
      "ends_at": "2026-08-22T03:29:43+00:00"
    }
  ],
  "count": 1
}

POST /campaigns

POST https://www.dextrending.net/api/v1/campaigns

Spends one available package against a pair.

Request body

{
  "credit_id": 20,
  "chain": "solana",
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "start_at": "asap",
  "notes": "listing at 14:00 UTC"
}

201 Created

{
  "campaign": {
    "order_no": "CMP-TK48JX43",
    "package": "24 Hour Window",
    "chain": "solana",
    "token": {
      "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "symbol": "Bonk",
      "name": "Bonk"
    },
    "hours": 24,
    "status": "scheduled",
    "starts_at": "2026-08-21T10:45:33+00:00",
    "ends_at": "2026-08-22T10:45:33+00:00"
  }
}

A complete launch

Validating with GET /token and picking from GET /packages before spending anything:

const BASE = "https://www.dextrending.net/api/v1";
const KEY  = process.env.DT_KEY;

async function dt(path, options = {}) {
  const res = await fetch(BASE + path, {
    ...options,
    headers: { "X-API-Key": KEY, "Content-Type": "application/json", ...(options.headers || {}) }
  });
  const body = await res.json();
  if (!res.ok) throw new Error(body.error || res.status);
  return body;
}

const chain   = "solana";
const address = "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263";

// 1. confirm the pair reads before spending anything
await dt(`/token?chain=${chain}&address=${address}`);

// 2. find a package that matches
const { packages } = await dt("/packages");
const ready = packages.find(p => p.status === "available" && p.chain_group === chain);
if (!ready) throw new Error("No package available for " + chain);

// 3. launch
const { campaign } = await dt("/campaigns", {
  method: "POST",
  body: JSON.stringify({ credit_id: ready.credit_id, chain, address, start_at: "asap" })
});

console.log(campaign.order_no, campaign.status);

Polling while it runs

Campaign state changes on the scale of hours, so poll GET /campaigns every few minutes at most. seconds_remaining tells you exactly how long is left, so you can sleep for that long rather than polling until it closes.

Questions