Перейти к основному содержанию

​
POST /tokens

Создать новый токен Launchpad. Auth: требуется.
​
name
string
обязательно
Отображаемое имя.
​
ticker
string
обязательно
Символ из 3–6 символов.
​
brief
string
Опциональное короткое описание; AI использует его для метаданных.
​
curve
object
Опциональное переопределение параметров кривой. Иначе — дефолты платформы.
​
allocation
object
Опциональное переопределение корзин аллокации. Ограничено общеплатформенными диапазонами.
curl -X POST https://api.agentflow.website/tokens \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{
    "name": "Hermes Dispatch",
    "ticker": "HERMES",
    "brief": "AI dispatcher for last-mile logistics"
  }'
Ответ 
{
  "id": "tok_01HQ...",
  "slug": "hermes-dispatch",
  "name": "Hermes Dispatch",
  "ticker": "HERMES",
  "imageUrl": "https://cdn.agentflow.website/...",
  "state": "prototype",
  "curve": {
    "initialPrice": 0.0001,
    "graduationThresholdFlow": 42000,
    "progressToGraduation": 0
  }
}

​
GET /tokens

Список токенов. Публичный. Query-параметры: cursor, state (prototype, graduating, sentient, failed), sort.

​
GET /tokens/:slug

Получить полное состояние токена, включая state, progressToGraduation, число держателей и последнюю цену сделки. Публичный. 
{
  "slug": "hermes-dispatch",
  "name": "Hermes Dispatch",
  "ticker": "HERMES",
  "state": "graduating",
  "progressToGraduation": 0.83,
  "lockedFlow": 34860,
  "graduationThresholdFlow": 42000,
  "estimatedTimeToGraduation": "2d 14h",
  "holdersCount": 412,
  "lastTradePrice": 0.0042
}

​
GET /tokens/:slug/holders

Список держателей токена, постранично. 
curl https://api.agentflow.website/tokens/hermes-dispatch/holders
Ответ 
{
  "items": [
    { "address": "0xabc...", "balance": 12500000, "share": 0.0125 }
  ],
  "nextCursor": "..."
}

​
POST /onchain/trades (curve buy/sell)

Внутренний торговый эндпоинт через сервис чейн-индексера. Публичный клиент использует UI Cabinet, который вызывает его. Эндпоинт валидирует слиппедж и обновляет FLOW-регистр. Канонической реализации для self-host см. в /Users/a1/Code/unimax_projects/fransh/agentflow-api/src/routes/onchain.ts.

​
Ошибки

КодКогда
ticker_takenТикер уже занят
invalid_tickerВне разрешённого набора символов
curve_out_of_rangeКастомная кривая вне лимитов платформы
token_not_foundSlug не существует
state_lockedСделка по failed или sentient токену