Add New Asset

Description

Registers a new asset in the system using a valid CoinGecko ID. A query to this endpoint should succeed within 30 seconds. The endpoint enriches the asset with metadata and auto-discovers associated DEX pools and CEX markets. The new asset becomes queryable via other endpoints (e.g. ticker, pool state) within ~30 seconds after success.

URL

POST https://pricing.aleno.ai/v1/assets

Headers

x-api-key: your-api-key
Content-Type: application/json

Request Body

Field	Type	Required	Description
coingeckoId	string	Yes	CoinGecko ID of the asset (e.g. bitcoin, wrapped-bitcoin). This ID is used to fetch token metadata and platform info.

Example Query

curl -X POST https://pricing.aleno.ai/v1/assets \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "coingeckoId": "flare-networks"
  }'

Responses

✅ Success (HTTP 200)

Asset was added successfully, along with newly discovered pools and/or CEX data.

{
  "success": true,
  "successMessage": "SUCCESS: new asset WBTC successfully added and should be available within 30 seconds for API. New pools for this assets: 12. New CEX data for this asset: 1."
}

⚠️ Conflict (HTTP 409)

The asset already exists in the system.

{
  "success": false,
  "errorMessage": "FAILED: Asset WBTC already exists."
}

❌ Validation Error (HTTP 400)

Missing or invalid coingeckoId.

{
  "success": false,
  "errorMessage": "FAILED: \"coingeckoId\" is required"
}

❌ External API Failure / Internal Error (HTTP 500)

CoinGecko fetch failed, pool discovery failed, or internal logic failed.

{
  "success": false,
  "errorMessage": "FAILED: failed to get coingecko coin for id: wrapped-bitcoin. Coingecko API returned HTTP status code 404"
}

or

{
  "success": false,
  "errorMessage": "FAILED: attempt to add new asset WBTC failed: failed to find pools for this token and no centralized exchange data found for this asset."
}