$npx -y skills add basezh/agent-skills-on-base --skill indexyIndexy is a cryptocurrency index management platform that enables AI agents to create, manage, and analyze crypto indices similar to ETFs. The platform provides comprehensive data access for KPIs, mindshare metrics, and public index analytics.
| 1 | # Indexy Agent Skill |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Indexy is a cryptocurrency index management platform that enables AI agents to create, manage, and analyze crypto indices similar to ETFs. The platform provides comprehensive data access for KPIs, mindshare metrics, and public index analytics. |
| 6 | |
| 7 | **Base API:** `https://indexy.co` |
| 8 | **Web App:** `https://indexy.xyz` |
| 9 | **Full API Docs:** `https://docs.indexy.xyz/api` |
| 10 | **Version:** 1.0.0 |
| 11 | |
| 12 | > **Important:** `indexy.co` is the API domain for all programmatic requests. `indexy.xyz` is the web app for human users. Never send API requests to `indexy.xyz`. |
| 13 | |
| 14 | ## Authentication |
| 15 | |
| 16 | Indexy supports two authentication methods. Choose the one that fits your use case: |
| 17 | |
| 18 | ### Method 1: API Key (Recommended for most agents) |
| 19 | |
| 20 | Include your API key as a Bearer token. API keys always start with the `agent_` prefix: |
| 21 | |
| 22 | ```http |
| 23 | Authorization: Bearer agent_your_key_here |
| 24 | ``` |
| 25 | |
| 26 | **Get Your API Key:** |
| 27 | 1. Log in to [indexy.xyz](https://indexy.xyz) |
| 28 | 2. Navigate to **Settings > Agent** |
| 29 | 3. Create and manage your API keys |
| 30 | |
| 31 | **Key Format:** All valid keys start with `agent_` followed by 64 hex characters (e.g., `agent_a1b2c3d4...`). |
| 32 | |
| 33 | **Security Warning:** NEVER share your API key or send it to domains other than `indexy.co` or `indexy.xyz`. |
| 34 | |
| 35 | ### Method 2: Web3 Authentication (For on-chain agents) |
| 36 | |
| 37 | Authenticate using EIP-191 signatures with an ERC-8004 Agent Identity NFT: |
| 38 | |
| 39 | **Required Headers:** |
| 40 | ```http |
| 41 | x-web3-address: 0xYourWalletAddress |
| 42 | x-web3-chain: base |
| 43 | x-web3-signature: 0xSignedMessage... |
| 44 | x-web3-message: Base64EncodedMessage |
| 45 | x-web3-timestamp: 1707500000000 |
| 46 | ``` |
| 47 | |
| 48 | **Supported Chains:** `base`, `ethereum` |
| 49 | |
| 50 | See full Web3 authentication flow at: `https://docs.indexy.xyz/api` |
| 51 | |
| 52 | ## Rate Limits |
| 53 | |
| 54 | - **Default:** 60 requests/minute per API key (configurable per key) |
| 55 | - **Headers:** `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` |
| 56 | - **Exceeded:** Returns `429 Too Many Requests` |
| 57 | |
| 58 | Custom rate limits can be configured per API key. Contact support for adjustments. |
| 59 | |
| 60 | ## Core Capabilities |
| 61 | |
| 62 | ### 1. Index Management (Create & Update) |
| 63 | |
| 64 | **Create an Index** |
| 65 | |
| 66 | Use this when agents want to build their own crypto portfolios: |
| 67 | |
| 68 | ``` |
| 69 | Create a DeFi blue chip index with: |
| 70 | - Uniswap: 40% |
| 71 | - Aave: 35% |
| 72 | - Curve: 25% |
| 73 | ``` |
| 74 | |
| 75 | **Tool:** `create_index` |
| 76 | **Endpoint:** `POST /beta/indexes/agent` |
| 77 | **Auth:** Required (API Key or Web3) |
| 78 | |
| 79 | All agent-created indices are marked as `index_category = 'agentic'`. |
| 80 | |
| 81 | **Body Parameters:** |
| 82 | |
| 83 | | Parameter | Type | Required | Description | |
| 84 | |-----------|------|----------|-------------| |
| 85 | | `name` | string | Yes | Index name (max 40 characters) | |
| 86 | | `description` | string | No | Index description (max 500 characters) | |
| 87 | | `weightsType` | string | No | `market_caps` or `custom` (default: `custom`) | |
| 88 | | `selectedAssets` | array | Yes | Array of 1-50 assets (weights must sum to 100) | |
| 89 | | `selectedAssets[].contractAddress` | string | Yes | Token contract address | |
| 90 | | `selectedAssets[].network` | string | Yes | Blockchain network (see Supported Networks below) | |
| 91 | | `selectedAssets[].weight` | number | Yes | Weight percentage (0-100) | |
| 92 | | `methodologyAssetEligibility` | string | No | Asset eligibility criteria (max 2000 characters) | |
| 93 | | `methodologyWeightCaps` | string | No | Weight caps methodology (max 2000 characters) | |
| 94 | | `methodologyRebalancingCadence` | string | No | Rebalancing schedule (max 2000 characters) | |
| 95 | |
| 96 | **Request Body Example:** |
| 97 | ```json |
| 98 | { |
| 99 | "name": "AI Layer-1 Index", |
| 100 | "description": "Top Layer-1 blockchains with AI integration capabilities", |
| 101 | "weightsType": "custom", |
| 102 | "selectedAssets": [ |
| 103 | { |
| 104 | "contractAddress": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984", |
| 105 | "network": "ethereum", |
| 106 | "weight": 40 |
| 107 | }, |
| 108 | { |
| 109 | "contractAddress": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9", |
| 110 | "network": "ethereum", |
| 111 | "weight": 35 |
| 112 | }, |
| 113 | { |
| 114 | "contractAddress": "0xd533a949740bb3306d119cc777fa900ba034cd52", |
| 115 | "network": "ethereum", |
| 116 | "weight": 25 |
| 117 | } |
| 118 | ], |
| 119 | "methodologyAssetEligibility": "Tokens must have a minimum market cap of $100M and be listed on at least 2 major exchanges.", |
| 120 | "methodologyWeightCaps": "No single asset can exceed 40% of the total index weight.", |
| 121 | "methodologyRebalancingCadence": "The index is rebalanced monthly on the first trading day of each month." |
| 122 | } |
| 123 | ``` |
| 124 | |
| 125 | **Success Response (201):** |
| 126 | ```json |
| 127 | { |
| 128 | "success": true, |
| 129 | "message": "Index created successfully", |
| 130 | "data": { |
| 131 | "indexId": 823, |
| 132 | "name": "AI Layer-1 Index", |
| 133 | "description": "Top Layer-1 blockchains with AI integration capabilities", |
| 134 | "weightsType": "custom", |
| 135 | "methodologyAssetEligibility": "Tokens must have a minimum market cap of $100M...", |
| 136 | "methodologyWeightCaps": "No single asset can exceed 40%...", |
| 137 | "methodologyRebalancingCadence": "The index is rebalanced monthly...", |
| 138 | "createdAt": "2026-02-10T16:30:00.000Z" |
| 139 | } |
| 140 | } |
| 141 | ``` |
| 142 | |
| 143 | --- |
| 144 | |
| 145 | **Update an Index** |
| 146 | |
| 147 | Modify existing indices you own: |
| 148 | |
| 149 | ``` |
| 150 | Update my index #123 to rebalance: increase Uniswap to 50%, decrease others proportionally |
| 151 | ``` |
| 152 | |
| 153 | **Tool:** `update_ind |