Assets

Browse and manage game assets including dragons and gateway keys

Assets API

Browse dragons, eggs, gateway keys, and other game assets. Most endpoints are public and do not require authentication.

List All Assets {#list-assets}

Retrieve paginated list of assets with comprehensive filtering.

Endpoint

GET /api/v1/assets

Authentication

Not required (public endpoint)

Query Parameters

Parameter	Type	Description
`accId`	string	Filter by account ID
`state`	string[]	Filter by asset state (SEALED, INCUBATING, HATCHING, HATCHED)
`house`	string[]	Filter by house element (FIRE, WATER, EARTH, AIR)
`magic`	string[]	Filter by magic element
`spawn`	string[]	Filter by spawn season
`hatch`	string[]	Filter by hatch season
`golden`	boolean	Filter for golden dragons
`celestialMagic`	boolean	Filter for celestial magic
`searchTerm`	string	Search term for asset name
`limit`	integer	Items per page (default: 25)
`offset`	integer	Pagination offset (default: 0)
`orderBy`	string	Sort field: `created`, `modified`, `rarity`, `eggDensity`
`orderDir`	string	Sort direction: `asc` or `desc` (default: desc)

Response

{
  "assets": [
    {
      "id": 12345,
      "accId": "account-id-123",
      "accDisplayName": "PlayerName",
      "created": 1699999999,
      "modified": 1699999999,
      "assetType": "DRAGON",
      "assetState": "SEALED",
      "charmOfMaking": "charm-string",
      "thumbnail": "https://...",
      "listingId": 0,
      "dragon": {
        "egg": { /* egg details */ },
        "dragon": { /* dragon details */ }
      }
    }
  ],
  "total": 1000
}

List Dragons {#list-dragons}

Retrieve only dragon assets (filtered view of all assets).

Endpoint

GET /api/v1/assets/dragons

Authentication

Not required (public endpoint)

Query Parameters

Same as List All Assets

Response

Same structure as List All Assets, filtered to assetType: "DRAGON" only

List Gateway Keys {#list-gateway-keys}

Retrieve only gateway key assets.

Endpoint

GET /api/v1/assets/gateway-keys

Authentication

Not required (public endpoint)

Query Parameters

Same as List All Assets

Response

{
  "assets": [
    {
      "id": 12345,
      "accId": "account-id-123",
      "accDisplayName": "PlayerName",
      "assetType": "GATEWAY_KEY",
      "assetState": "ACTIVE",
      "gatewayKey": {
        "id": 12345,
        "age": 1,
        "season": "PRIMORDIAL",
        "isGolden": false,
        "thumbnail": "https://..."
      }
    }
  ],
  "total": 100
}

Get Asset Statistics {#get-asset-stats}

Retrieve aggregate statistics for assets.

Endpoint

GET /api/v1/assets/stats

Authentication

Not required (public endpoint)

Query Parameters

Parameter	Type	Description
`accId`	string	Get stats for specific account (omit for global stats)

Response

{
  "accId": "",
  "totalAssets": 10000,
  "totalDragons": 5000,
  "totalSealedEggs": 2000,
  "totalIncubatingEggs": 1500,
  "totalHatchingEggs": 500,
  "totalGoldenEggs": 100,
  "totalGatewayKeys": 1000
}

Get Asset Details {#get-asset}

Retrieve complete details for a specific asset including full genome data.

Endpoint

GET /api/v1/assets/{assetId}

Authentication

Not required (public endpoint)

Path Parameters

Parameter	Type	Description
`assetId`	integer	Numeric asset ID

Response

{
  "id": 12345,
  "accId": "account-id-123",
  "accDisplayName": "PlayerName",
  "assetType": "DRAGON",
  "assetState": "HATCHED",
  "dragon": {
    "egg": {
      "id": 67890,
      "hatchState": "HATCHED",
      "house": "FIRE",
      "magicElement": "LIGHTNING",
      "spawnSeason": "PRIMORDIAL",
      "golden": false
    },
    "dragon": {
      "version": 1,
      "house": "FIRE",
      "magicElement": "LIGHTNING",
      "genome": { /* complete genome data */ },
      "colorGeneClusters": {},
      "magicInfo": {},
      "nameInfo": {}
    }
  }
}

Get Asset Media {#get-asset-media}

Retrieve paginated list of media files (images, videos) for an asset.

Endpoint

GET /api/v1/assets/{assetId}/medias

Authentication

Not required (public endpoint)

Path Parameters

Parameter	Type	Description
`assetId`	integer	Numeric asset ID

Query Parameters

Parameter	Type	Description
`limit`	integer	Items per page (default: 100, max: 100)
`offset`	integer	Pagination offset (default: 0)

Response

[
  {
    "id": 1,
    "created": 1699999999,
    "thumbnail": "https://...",
    "mediaLink": "https://...",
    "eggId": 12345,
    "type": "EGG",
    "metadata": {}
  },
  {
    "id": 2,
    "created": 1700000000,
    "thumbnail": "https://...",
    "mediaLink": "https://...",
    "eggId": 12345,
    "type": "DRAGON",
    "metadata": {}
  }
]

Media Types

EGG - Egg artwork
DRAGON - Dragon artwork
GATEWAY_KEY - Gateway key artwork

Get Magic Potential {#get-magic-potential}

Calculate celestial magic potential for a dragon egg.

Endpoint

GET /api/v1/assets/magic/{assetId}

Authentication

Not required (public endpoint)

Path Parameters

Parameter	Type	Description
`assetId`	integer	Numeric asset ID (must be dragon type)

Response

{
  "magicPotential": "GUARANTEED STABLE CELESTIAL MAGIC"
}

Possible Values

Value	Description
`GUARANTEED STABLE CELESTIAL MAGIC`	Low density egg with sufficient incubation
`POSSIBLE STABLE CELESTIAL MAGIC`	Low density egg without sufficient incubation
`POSSIBLE UNSTABLE CELESTIAL MAGIC`	High density egg with insufficient incubation
`CELESTIAL MAGIC NOT POSSIBLE`	High density egg with sufficient incubation

Business Logic

Only works for DRAGON asset type
Asset must NOT be in HATCHED or HATCHING state
Low density eggs (density < 1,000,000):
- If incubated AND current blocks > density: GUARANTEED STABLE
- Otherwise: POSSIBLE STABLE
High density eggs (density >= 1,000,000):
- If NOT incubated OR current blocks < density: POSSIBLE UNSTABLE
- Otherwise: NOT POSSIBLE