# Introduction

A small REST API for buying-side automation: list your packages, launch campaigns against a pair, and track them from your own code.

The API covers everything the panel does after a package is paid for. You cannot buy a package through
it — payment goes through a wallet signature and stays in the browser — but you can spend packages you
already hold, and monitor everything that results.

## Base URL

```
https://www.dextrending.net/api/v1
```

All responses are JSON. All requests authenticate with an API key in a header.
Authentication details.

## Endpoints

| Method | Path | Purpose |
| ------ | ------------ | ---------------------------------------------- |
| `GET` | `/packages` | Every package on the account and its state |
| `GET` | `/campaigns` | Campaigns with live status and progress |
| `POST` | `/campaigns` | Launch one available package against a pair |
| `GET` | `/token` | Read a token before committing a package to it |

## Core flow

- Confirm the pair reads. `GET /token` with the chain and contract address. A 404
here means a launch would fail too.

- Find an available package. `GET /packages` and pick one
whose `status` is `available`.

- Launch it. `POST /campaigns` with that `credit_id`, the chain and the
address.

- Track it. `GET /campaigns` returns status, progress and seconds remaining.

Packages are the unit of currency here. The API spends packages you already own; it never charges a
card or moves funds.

## Conventions

- Timestamps are ISO 8601 in UTC, for example `2026-08-21T10:45:33+00:00`.

- Chains are lowercase identifiers: `solana`, `ethereum`,
`bsc`, `base`, `arbitrum`, `polygon`,
`avalanche`.

- Errors return a matching HTTP status and a JSON body with an `error`
string. Full list.

- Everything is scoped to your key. You only ever see your own packages and
campaigns.

## Before you build

Launching is irreversible and spends a package, so validate the address with `GET /token`
first. It costs nothing and it is the same lookup the panel runs.

Also worth knowing: the campaign chain must match the package group. A Solana package cannot launch
against an EVM pair, and the API returns a 400 rather than consuming the package.

## Questions

**Can I buy a package through the API?**

No. Payment requires a wallet signature and stays in the browser. The API spends packages you already hold.

**Is the API included, or does it cost extra?**

Included. Any account can generate a key from the panel at no charge.

**Is there a sandbox environment?**

No separate sandbox. GET /token is free and unlimited within the rate limit, so validate addresses with that before spending a package.