Collections

🎨 Collections API

Access iNFT collection data and statistics.

Collection Tiers:

• Gold: Premium tier (limited supply)

• Silver: Mid-tier collection

• Bronze: Entry-level tier

Data Includes:

• Minting progress and supply

• Royalty information

• Contract addresses

• Collection statistics

List all collections

get

Retrieve information about all iNFT collections (Gold, Silver, Bronze) including statistics, minting progress, and metadata.

Returns:

• Collection metadata and contract addresses

• Minting progress and supply information

• Royalty percentages

• Overall summary statistics

Responses

200

OK

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

get

/collections

cURLfetch

curl -s "https://api.twnlabs.com/v1/collections"

{
  "success": true,
  "data": {
    "collections": [
      {
        "family": "TWN Labs",
        "name": "TWN Gold Collection",
        "tier": "gold",
        "symbol": "TWNG",
        "description": "Unique AI Twins powered by TWN Labs - Gold Tier",
        "cap": 100,
        "weight": 10,
        "nft_minted": 1,
        "seller_fee_basis_points": 0,
        "contract_address": "collection12345678901",
        "creator_address": "none",
        "metadata_uri": "https://arweave.net/gold-metadata",
        "image_uri": "https://arweave.net/gold-image",
        "network": "mainnet",
        "is_active": true,
        "created_at": "2025-09-26 20:10:46",
        "updated_at": "2025-10-05 02:09:21",
        "stats": {
          "progress_percentage": 1,
          "royalty_percentage": 0,
          "remaining_supply": 99
        },
        "links": {
          "explore": "/collections/gold",
          "twins_api": "/v1/collections/gold/twins",
          "collection_api": "/v1/collections/gold"
        }
      }
    ],
    "summary": {
      "total_collections": 3,
      "total_minted": 3,
      "total_capacity": 1350,
      "overall_progress": 0.22
    },
    "meta": {
      "timestamp": "2025-10-26T08:22:56+03:00",
      "api_version": "v1",
      "endpoint": "/v1/collections"
    }
  }
}

Get collection by tier

get

Retrieve detailed information about a specific collection tier.

Available Tiers:

• gold - Premium tier with limited supply

• silver - Mid-tier collection

• bronze - Entry-level tier

Path parameters

tierstring · enumRequired

Collection tier

Example: goldPossible values:

Responses

200

OK

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

get

/collections/{tier}

HTTPcURLJavaScriptPython

GET /v1/collections/{tier} HTTP/1.1
Host: api.twnlabs.com
Accept: */*

{
  "success": true,
  "data": {
    "collection": {
      "family": "TWN Labs",
      "name": "TWN Gold Collection",
      "tier": "gold",
      "symbol": "TWNG",
      "description": "Unique AI Twins powered by TWN Labs - Gold Tier",
      "cap": 100,
      "weight": 10,
      "nft_minted": 1,
      "seller_fee_basis_points": 0,
      "contract_address": "collection12345678901",
      "creator_address": "none",
      "metadata_uri": "https://arweave.net/gold-metadata",
      "image_uri": "https://arweave.net/gold-image",
      "network": "mainnet",
      "is_active": true,
      "created_at": "2025-09-26 20:10:46",
      "updated_at": "2025-10-05 02:09:21"
    },
    "stats": {
      "progress_percentage": 1,
      "royalty_percentage": 0,
      "remaining_supply": 99
    },
    "links": {
      "explore": "/collections/gold",
      "twins_api": "/v1/collections/gold/twins",
      "collection_api": "/v1/collections/gold"
    }
  }
}

List twins in collection

get

Retrieve all twins belonging to a specific collection tier with pagination support.

Use Cases:

• Browse all Gold tier twins

• Get paginated results for large collections

• Filter twins by collection membership

Path parameters

tierstring · enumRequired

Collection tier to filter twins

Example: silverPossible values:

Query parameters

limitinteger · min: 1 · max: 50Optional

Maximum number of twins per page (max 50)

Example: 20

offsetintegerOptional

Number of twins to skip for pagination

Example: 0

Responses

200

OK

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

get

/collections/{tier}/twins

HTTPcURLJavaScriptPython

GET /v1/collections/{tier}/twins HTTP/1.1
Host: api.twnlabs.com
Accept: */*

{
  "success": true,
  "twins": [
    {
      "twin_id": "TWN-G0",
      "twin_name": "Kurohane (黒羽)",
      "twin_description": "闇を超えて、光を守る。",
      "twin_birthdate": "1999-02-15",
      "twin_nationality": "JP",
      "languages": [
        "ja"
      ],
      "collection_type": "gold",
      "is_minted": false,
      "mint_date": "2025-10-24 23:35:29",
      "avatar_url": "\\assets\\avatars\\2025\\08\\a3f8d9e2b1c4567890ab.png",
      "image_url": "https://arweave.net/sample123456789011",
      "contract_address": "",
      "creator_address": "",
      "token_address": "",
      "creator_wallet": "",
      "twitter": "https://x.com/twnlabs",
      "instagram": "https://instagram.com/twnlabs",
      "discord": "https://discord.gg/xTtc6ZFdSN",
      "twitch": "https://twitch.tv/",
      "like_count": 0,
      "interaction_count": 0,
      "share_count": 0,
      "rating": 0,
      "created_at": "2025-08-04 21:52:18"
    }
  ],
  "total": 45,
  "limit": 10,
  "offset": 0,
  "hasMore": true
}