Tokens API

Off-chain метаданные для токенов, запущенных через factory.launch(). Ончейн-чтения — через чейн-индексер.

Tokens API — тонкий слой метаданных поверх ончейн-LaunchpadFactory и инстансов шаблонов. Сам launch всегда инициируется кошельком — API не кастодит ключи. Эти эндпоинты делают:

• Pre-flight метаданные (имя, тикер, описание, картинка, теги) до подписи.
• Post-launch reconciliation (привязка адреса instance к slug, AI-fill, загрузка картинки).
• Read-side запросы из чейн-индексера (state, holders, trades).

​

POST /tokens

Зарегистрировать off-chain метаданные для токена, который вы собираетесь запустить (или только что запустили). Auth: нужен.

template · string · обязательно

Один из virtuals, dpnm. Больше шаблонов добавляется по мере отгрузки.

name · string · обязательно

Отображаемое имя.

ticker · string · обязательно

Символ из 3–6 символов.

brief · string

Опциональное краткое описание; AI использует это для заполнения более богатых метаданных.

params · object · обязательно

Параметры для конкретного шаблона. Форма зависит от шаблона — см. Создать токен.

instance · address

Опционально. Если уже развернули через factory.launch(...), передайте адрес инстанса; API пропустит свой launch-флоу и просто сохранит метаданные.

chainId · number · обязательно

Сеть для запуска. 97 = BSC testnet, 56 = BSC mainnet (когда живая), 8453 = Base mainnet (Phase 2).

curl

curl -X POST https://api.agentflow.website/tokens \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{
    "template": "dpnm",
    "name": "Hermes Token",
    "ticker": "HERMES",
    "brief": "AI dispatcher token",
    "chainId": 97,
    "params": {
      "initialPrice": "0.1",
      "dailyLimitFloor": "50",
      "incomeLimitMultiplier": 2,
      "treeActivationCost": "10"
    }
  }'

Ответ

{
  "id": "tok_01HQ...",
  "slug": "hermes-token",
  "name": "Hermes Token",
  "ticker": "HERMES",
  "template": "dpnm",
  "instance": "0x6B7700395708a0B2578B5E3d58b895C34a24e959",
  "chainId": 97,
  "imageUrl": "https://cdn.agentflow.website/tokens/...",
  "state": "live",
  "createdAt": "2026-04-26T10:31:00Z"
}

Если instance не указан в запросе, в ответе будет ещё поле pendingLaunchTx с энкодед-calldata, которое кошельку пользователя нужно подписать.

​

GET /tokens

Список токенов. Public.

Query params: cursor, template (virtuals | dpnm), state (live, graduating, sentient, failed), chainId, sort.

​

GET /tokens/:slug

Получить полное состояние токена, включая ончейн-чтения из чейн-индексера. Public.

{
  "slug": "hermes-token",
  "name": "Hermes Token",
  "ticker": "HERMES",
  "template": "virtuals",
  "instance": "0x...",
  "chainId": 97,
  "state": "graduating",
  "progressToGraduation": 0.83,
  "lockedPaymentToken": "34860",
  "graduationThreshold": "42000",
  "estimatedTimeToGraduation": "2d 14h",
  "holdersCount": 412,
  "lastTradePrice": "0.0042"
}

Для dpnm-токенов форма ответа отличается:

{
  "slug": "flow",
  "ticker": "FLOW",
  "template": "dpnm",
  "instance": "0x2680b933af7a874d20954b03F38C86891A786511",
  "flowProtocol": "0x7F20f8e6e5077a4E11A1A2Fe54449ab55D32f653",
  "phenomenalTree": "0x9E12238d24Eece9b7575a53b17e36515eaEE0A30",
  "gwt": "0x40711d364b680ad7e85429bd36d7237E4e960783",
  "currentPrice": "0.1234",
  "poolUsdt": "150000",
  "totalSupply": "1216000",
  "holdersCount": 89,
  "treeActivePositions": 73
}

​

GET /tokens/:slug/holders

Список держателей токена с пагинацией. Public. Читает из чейн-индексера.

{
  "items": [
    { "address": "0xabc...", "balance": "12500000", "share": 0.0125 }
  ],
  "nextCursor": "..."
}

​

GET /tokens/:slug/trades

Список последних buy и sell (и graduations для virtuals). Источник — swap_events в чейн-индексере.

​

Errors

Code	When
ticker_taken	Тикер уже занят
invalid_ticker	Вне разрешённого диапазона символов
template_unknown	Template id не зарегистрирован в этой сети
params_invalid	Форма params не подходит шаблону
chain_unsupported	chainId не сконфигурирован
token_not_found	Slug не существует

Все ончейн-взаимодействия (launch, buy, sell, activate, extendTree, claimGWT и т. д.) идут прямо с кошелька пользователя. API никогда не подписывает за пользователя.