Tokens & Trading

Company tokens follow a lifecycle: PRE_PUBLIC -> BONDING (Bancor curve) -> GRADUATED (Uniswap V4 + CeosHook 2.5% fee). These endpoints return token status, pricing, and market data.

GET /api/companies/[id]/token

Returns token status, current price, market cap, and graduation progress. Reads on-chain from CompanyTokenLauncher for BONDING tokens.

Parameters

Parameter	In	Type	Required	Description
`id`	path	string	Yes	Company slug

Response (BONDING)


{
  "success": true,
  "data": {
    "slug": "alphavault",
    "name": "AlphaVault",
    "status": "BONDING",
    "tokenAddress": "0xabc...",
    "tokenSymbol": "$ALPHA",
    "price": "0.045200",
    "marketCap": "4520.000000",
    "graduationThreshold": 10000,
    "graduationProgress": 45.2,
    "graduated": false,
    "graduatedAt": null,
    "v4PoolAddress": null
  }
}

Response (PRE_PUBLIC)


{
  "success": true,
  "data": {
    "slug": "newco",
    "status": "PRE_PUBLIC",
    "tokenAddress": null,
    "tokenSymbol": null,
    "price": null,
    "marketCap": null,
    "graduationProgress": 0
  }
}

Response (GRADUATED)


{
  "success": true,
  "data": {
    "slug": "alphavault",
    "name": "AlphaVault",
    "status": "GRADUATED",
    "tokenAddress": "0xabc...",
    "tokenSymbol": "$ALPHA",
    "price": "0.125000",
    "marketCap": "12500.000000",
    "graduationThreshold": 10000,
    "graduationProgress": 100,
    "graduated": true,
    "graduatedAt": "2026-03-20T15:30:00.000Z",
    "v4PoolAddress": "0xdef..."
  }
}

Price and market cap are formatted in USDC (6 decimals). graduationProgress is a percentage (0-100) representing market cap relative to the graduation threshold ($10K default).


curl https://ceos.run/api/companies/alphavault/token

GET /api/v1/companies/[slug]/token

Public API v1 token endpoint with additional metadata. Requires API key.

Authentication

API key via x-api-key header.

Response


{
  "data": {
    "companyId": "clx9...",
    "name": "AlphaVault",
    "slug": "alphavault",
    "tokenStatus": "BONDING",
    "tokenSymbol": "$ALPHA",
    "tokenAddress": "0xabc...",
    "bondingCurve": {
      "address": "0x789...",
      "graduationThreshold": 10000,
      "graduated": false,
      "graduatedAt": null
    },
    "v4Pool": {
      "address": null
    },
    "launchTxHash": "0xfed...",
    "publicAt": "2026-03-10T00:00:00.000Z"
  },
  "meta": {
    "timestamp": "2026-03-28T12:00:00.000Z"
  }
}


curl -H "x-api-key: sk_live_..." "https://ceos.run/api/v1/companies/alphavault/token"

GET /api/v1/tokens

Lists all company tokens (bonding + graduated). Requires API key.

Authentication

API key via x-api-key header.

Query Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	50	Results per page (max 100)
`status`	string	-	Filter: `BONDING` or `GRADUATED`

Response


{
  "data": [
    {
      "id": "clx9...",
      "name": "AlphaVault",
      "slug": "alphavault",
      "tokenStatus": "BONDING",
      "tokenSymbol": "$ALPHA",
      "tokenAddress": "0xabc...",
      "bondingCurveAddress": "0x789...",
      "graduationThreshold": 10000,
      "graduatedAt": null,
      "v4PoolAddress": null,
      "ceosScore": 87.3,
      "category": "DEFI_YIELD",
      "publicAt": "2026-03-10T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 24,
    "hasMore": false
  },
  "meta": {
    "timestamp": "2026-03-28T12:00:00.000Z"
  }
}


curl -H "x-api-key: sk_live_..." "https://ceos.run/api/v1/tokens?status=BONDING&limit=10"

Error Codes

Status	Code	Description
400	VALIDATION_ERROR	Invalid query parameters
401	UNAUTHORIZED	Missing or invalid API key
429	RATE_LIMITED	Rate limit exceeded