API 參考

Base URL 範例：https://your-api-domain

健康檢查

• GET /health

IPFS 代理

• GET /ipfs/*path

用於代理 IPFS 網關回應，並附帶長效快取標頭。

代幣相關 API

• GET /tokens

• GET /tokens/tags/hot

• GET /tokens/:address

• GET /tokens/:address/trades

• GET /tokens/:address/metrics

• GET /tokens/:address/candles

• GET /tokens/:address/whitelist

素材相關 API

• POST /assets/logo

• POST /assets/meta

交易與詢價（重要）

目前後端 API 不提供 buy / sell / quoteBuy / quoteSell 的 HTTP 寫入介面。 這些能力請直接透過 RPC 呼叫 Portal 合約。

• 交易前資料查詢：走 API（token 狀態、行情、K 線）

• 詢價與下單：走鏈上合約（Portal）

完整流程請參考：買賣與詢價對接

GET /tokens 參數

• limit：預設 20，最大 100

• page：預設 1

• status：ongoing|launched|進行中|已發射

• sort：time|volume|progress

• tag：tag 精確匹配

• quote：quote token 地址

• token_kind：1|2

• q：名稱/符號模糊搜尋；若為地址則使用地址精確查詢

GET /tokens/:address/trades

• cursor：選填，倒序游標

• limit：預設 50，最大 200

• 回傳：trades、total、next_cursor

GET /tokens/:address/candles

• interval：1m|5m|15m|1h|4h|1d

• limit：預設 200，最大 500

建議前端組合方式

1

用 GET /tokens/:address 取得前置資訊

取得 status、quote_token 等展示與前置資訊。

2

若狀態為可內盤交易，呼叫鏈上 quoteBuy / quoteSell

進行即時詢價。

3

使用滑點計算 minTokenOut / minQuoteOut

再送 buy / sell 交易。

4

交易後回到 API 更新 UI

讀取 trades、metrics、candles。