# Send Indexy to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "indexy",
    "name": "Indexy",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/hsantana/indexy",
    "canonicalUrl": "https://clawhub.ai/hsantana/indexy",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/indexy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=indexy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "skill.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "indexy",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T09:27:03.639Z",
      "expiresAt": "2026-05-11T09:27:03.639Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=indexy",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=indexy",
        "contentDisposition": "attachment; filename=\"indexy-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "indexy"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/indexy"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/indexy",
    "downloadUrl": "https://openagent3.xyz/downloads/indexy",
    "agentUrl": "https://openagent3.xyz/skills/indexy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/indexy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/indexy/agent.md"
  }
}
```
## Documentation

### Overview

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.

Base API: https://indexy.co
Web App: https://indexy.xyz
Full API Docs: https://docs.indexy.xyz/api
Version: 1.0.0

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.

### Authentication

Indexy supports two authentication methods. Choose the one that fits your use case:

### Method 1: API Key (Recommended for most agents)

Include your API key as a Bearer token. API keys always start with the agent_ prefix:

Authorization: Bearer agent_your_key_here

Get Your API Key:

Log in to indexy.xyz
Navigate to Settings > Agent
Create and manage your API keys

Key Format: All valid keys start with agent_ followed by 64 hex characters (e.g., agent_a1b2c3d4...).

Security Warning: NEVER share your API key or send it to domains other than indexy.co or indexy.xyz.

### Method 2: Web3 Authentication (For on-chain agents)

Authenticate using EIP-191 signatures with an ERC-8004 Agent Identity NFT:

Required Headers:

x-web3-address: 0xYourWalletAddress
x-web3-chain: base
x-web3-signature: 0xSignedMessage...
x-web3-message: Base64EncodedMessage
x-web3-timestamp: 1707500000000

Supported Chains: base, ethereum

See full Web3 authentication flow at: https://docs.indexy.xyz/api

### Rate Limits

Default: 60 requests/minute per API key (configurable per key)
Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Exceeded: Returns 429 Too Many Requests

Custom rate limits can be configured per API key. Contact support for adjustments.

### 1. Index Management (Create & Update)

Create an Index

Use this when agents want to build their own crypto portfolios:

Create a DeFi blue chip index with:
- Uniswap: 40%
- Aave: 35%
- Curve: 25%

Tool: create_index
Endpoint: POST /beta/indexes/agent
Auth: Required (API Key or Web3)

All agent-created indices are marked as index_category = 'agentic'.

Body Parameters:

ParameterTypeRequiredDescriptionnamestringYesIndex name (max 40 characters)descriptionstringNoIndex description (max 500 characters)weightsTypestringNomarket_caps or custom (default: custom)selectedAssetsarrayYesArray of 1-50 assets (weights must sum to 100)selectedAssets[].contractAddressstringYesToken contract addressselectedAssets[].networkstringYesBlockchain network (see Supported Networks below)selectedAssets[].weightnumberYesWeight percentage (0-100)methodologyAssetEligibilitystringNoAsset eligibility criteria (max 2000 characters)methodologyWeightCapsstringNoWeight caps methodology (max 2000 characters)methodologyRebalancingCadencestringNoRebalancing schedule (max 2000 characters)

Request Body Example:

{
  "name": "AI Layer-1 Index",
  "description": "Top Layer-1 blockchains with AI integration capabilities",
  "weightsType": "custom",
  "selectedAssets": [
    {
      "contractAddress": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
      "network": "ethereum",
      "weight": 40
    },
    {
      "contractAddress": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
      "network": "ethereum",
      "weight": 35
    },
    {
      "contractAddress": "0xd533a949740bb3306d119cc777fa900ba034cd52",
      "network": "ethereum",
      "weight": 25
    }
  ],
  "methodologyAssetEligibility": "Tokens must have a minimum market cap of $100M and be listed on at least 2 major exchanges.",
  "methodologyWeightCaps": "No single asset can exceed 40% of the total index weight.",
  "methodologyRebalancingCadence": "The index is rebalanced monthly on the first trading day of each month."
}

Success Response (201):

{
  "success": true,
  "message": "Index created successfully",
  "data": {
    "indexId": 823,
    "name": "AI Layer-1 Index",
    "description": "Top Layer-1 blockchains with AI integration capabilities",
    "weightsType": "custom",
    "methodologyAssetEligibility": "Tokens must have a minimum market cap of $100M...",
    "methodologyWeightCaps": "No single asset can exceed 40%...",
    "methodologyRebalancingCadence": "The index is rebalanced monthly...",
    "createdAt": "2026-02-10T16:30:00.000Z"
  }
}

Update an Index

Modify existing indices you own:

Update my index #123 to rebalance: increase Uniswap to 50%, decrease others proportionally

Tool: update_index
Endpoint: PATCH /beta/indexes/agent/{indexId}
Auth: Required (must be the index creator)

Supports two modes determined by the fields you include:

Metadata only: Send only name, description, or methodology* fields. The asset composition remains unchanged.
Full rebalance: Include a selectedAssets array. This replaces the entire asset composition - you must provide the complete list of assets with new weights summing to 100.

Metadata-Only Update Example:

{
  "name": "Updated AI Index",
  "description": "Refined strategy focusing on top AI-integrated chains",
  "methodologyRebalancingCadence": "Rebalanced bi-weekly on Mondays"
}

Full Rebalance Example:

{
  "selectedAssets": [
    {
      "contractAddress": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
      "network": "ethereum",
      "weight": 60
    },
    {
      "contractAddress": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
      "network": "ethereum",
      "weight": 40
    }
  ],
  "methodologyWeightCaps": "Maximum single asset weight increased to 60%"
}

Response Example (200):

{
  "success": true,
  "message": "Index updated successfully",
  "data": {
    "indexId": 823
  }
}

### 2. Read Your Indices

List Your Indices

Show me all indices I've created

Tool: list_my_indexes
Endpoint: GET /beta/indexes/agent
Auth: Required

Query Parameters:

ParameterTypeDefaultDescriptionpageinteger1Page numberlimitinteger10Results per page (max: 50)

Response Example:

{
  "success": true,
  "data": [
    {
      "id": 823,
      "name": "AI Layer-1 Index",
      "description": "Top Layer-1 blockchains with AI integration capabilities",
      "weights_type": "custom",
      "index_category": "agentic",
      "current_bps": 105.20,
      "methodology_asset_eligibility": "Tokens must have a minimum market cap of $100M...",
      "methodology_weight_caps": "No single asset can exceed 40%...",
      "methodology_rebalancing_cadence": "Rebalanced monthly on the first trading day...",
      "created_at": "2026-02-10T16:30:00.000Z",
      "updated_at": "2026-02-10T16:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "totalCount": 1,
    "totalPages": 1
  }
}

Field Definitions:

current_bps - The index's BPS (Basis Point Score). Starts at 100.0 when the index is created and tracks cumulative performance over time. A value of 105.20 means the index has grown 5.2% since creation. Calculated as: previousBps + weightedPerformanceChange.

Get Index Details

Show me the full composition of my index #456

Tool: get_index
Endpoint: GET /beta/indexes/agent/{indexId}
Auth: Required (must be the index creator)

Response Example:

{
  "success": true,
  "data": {
    "id": 823,
    "name": "AI Layer-1 Index",
    "description": "Top Layer-1 blockchains with AI integration capabilities",
    "weights_type": "custom",
    "index_category": "agentic",
    "current_bps": 105.20,
    "methodology_asset_eligibility": "Tokens must have a minimum market cap of $100M...",
    "methodology_weight_caps": "No single asset can exceed 40%...",
    "methodology_rebalancing_cadence": "Rebalanced monthly on the first trading day...",
    "created_at": "2026-02-10T16:30:00.000Z",
    "updated_at": "2026-02-10T16:30:00.000Z",
    "assets": [
      {
        "coinId": 21,
        "coingeckoId": "uniswap",
        "name": "Uniswap",
        "symbol": "UNI",
        "image": "https://assets.coingecko.com/coins/images/12504/large/uniswap.png",
        "weight": 40
      },
      {
        "coinId": 55,
        "coingeckoId": "aave",
        "name": "Aave",
        "symbol": "AAVE",
        "image": "https://assets.coingecko.com/coins/images/12645/large/aave.png",
        "weight": 35
      }
    ]
  }
}

Note: The response returns coingeckoId in asset details for reference, but the request requires contractAddress + network to create/update assets.

### 3. Public Data Access (No Auth Required)

Browse All Indices

Show me all featured indices
What are the top custom-weighted indices?
List indices created by user #128

Tool: get_public_indexes
Endpoint: GET /beta/indexes
Auth: Not required

Query Parameters:

ParameterTypeDefaultDescriptionfeaturedboolean-Only return featured (curated) indicesweights_typestring-Filter by: market_caps or customcreator_idinteger-Filter by creator user IDindex_categorystring-Filter by: community, agentic, or ecosystemlimitinteger20Items per page (max 100)offsetinteger0Number of items to skip

Response: Same structure as "List Your Indices" response above.

Get Any Public Index

What's in the DeFi Leaders index (ID #42)?
Show me the composition of index #107

Tool: get_public_index
Endpoint: GET /beta/indexes/{id}
Auth: Not required

Response: Same structure as "Get Index Details" response above.

### 4. Index Highlights

Get Highlighted Indexes

Show me the top performing indices
What's trending right now?

Tool: get_index_highlights
Endpoint: GET /beta/highlights/indexes
Auth: Not required

Query Parameters:

ParameterTypeDefaultDescriptioncategorystring-Filter by: new, top_performers, trendinglimitinteger10Results per page (max: 100)offsetinteger0Number of results to skip

Response Example:

{
  "success": true,
  "highlights": [
    {
      "index_id": 42,
      "category": "top_performers",
      "position": 1,
      "index_name": "DeFi Blue Chips",
      "metric_value": 15.5,
      "market_cap_change": 8.32,
      "creator_username": "defi_wizard"
    }
  ]
}

### 5. KPI Analytics

Indexy calculates four KPI metrics for all coins and indices. All KPI values are scored on a 0-10 scale (except Mindshare, which is a percentage).

Available KPIs:

KPIScaleDescriptionBitcoin Strength0-10Measures performance relative to Bitcoin. 5.0 = equal to BTC. Above 5 = outperforming BTC. Below 5 = underperforming. Calculated as relative return difference normalized to +-20% range.Volatility0-10Measures price stability. Higher = more volatile. Uses standard deviation of price changes across time windows. Weighted: 10% 24H, 30% 1W, 30% 1M, 20% 3M, 5% 6M, 5% 1Y.All-Time High0-10Proximity to all-time high market cap. 10 = at ATH, 0 = at lowest point since ATH. Linear interpolation between ATH and lowest value.Mindshare0-100%Market attention metric (see Section 6 for full details).

Get KPIs for an Index

What's the Bitcoin Strength of index #42?
Show me volatility for my DeFi index

Endpoints (one per KPI):

GET /api/kpis/bitcoin-strength/{indexId} - Bitcoin Strength KPI
GET /api/kpis/volatility/{indexId} - Volatility KPI
GET /api/kpis/all-time-high/{indexId} - All-Time High KPI
GET /api/kpis/mindshare/{indexId} - Mindshare KPI

Auth: Not required

Response Example (all KPI endpoints):

{
  "value": 6.8
}

The value is the overall score - a weighted average across all time ranges. Returns { "value": 0 } if no data is available.

Get KPIs for Coins or Indices (Batch)

What's the volatility of the top 10 coins?
Show me Bitcoin strength metrics for Ethereum this week

Tool: get_kpis_coins
Endpoint: GET /beta/kpis/coins

Tool: get_kpis_indexes
Endpoint: GET /beta/kpis/indexes

Query Parameters:

ParameterTypeDefaultDescriptionkpi_idinteger-Filter by specific KPI IDcoin_id / index_idinteger-Filter by specific coin or indextime_rangestring-One of: 24H, 1W, 1M, 3M, 6M, 1Y, overalllimitinteger100Results per page (max: 1000)offsetinteger0Number of results to skiplatest_onlybooleantrueReturn only most recent datagroup_by_coin / group_by_indexbooleantrueGroup results by coin/index for nested structure

Grouped Response Example (default):

{
  "success": true,
  "indexes": [
    {
      "index_id": 42,
      "index_name": "DeFi Blue Chips",
      "kpis": [
        {
          "kpi_id": 1,
          "kpi_name": "Volatility",
          "value": 28.7,
          "time_range": "24H",
          "date": "2026-02-10T18:00:00.000Z"
        }
      ]
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 100,
    "offset": 0,
    "has_more": true
  }
}

Time Ranges Available: 24H, 1W, 1M, 3M, 6M, 1Y, overall

The overall time range is a weighted average:

Bitcoin Strength & Volatility: 10% 24H + 30% 1W + 30% 1M + 20% 3M + 5% 6M + 5% 1Y
All-Time High: 5% 24H + 5% 1W + 20% 1M + 25% 3M + 20% 6M + 15% 1Y + 10% ALL_TIME
Mindshare: 30% 24H + 30% 1W + 20% 1M + 20% 3M

### 6. Mindshare Data

Mindshare is a proprietary metric measuring "market attention" across two dimensions:

Coin Mindshare measures how frequently a coin is included in user-created indices:

Formula: (coin's inclusion count across indices / total inclusions) x 100%

Example: If Bitcoin appears in 15 indices and there are 100 total coin-index pairings, Bitcoin's mindshare = 15%.

Index Mindshare combines two equally weighted components:

Index Mindshare = 50% Coin Composition Score + 50% Engagement Score

Coin Composition Score = weighted average of constituent coins' mindshare
  - For market_caps indices: uses market cap as weights
  - For custom indices: uses user-defined weights

Engagement Score = 25% view share + 25% track share
  - View share = (index views / total views in period) x 100%
  - Track share = (index tracks / total tracks in period) x 100%

Coin Mindshare

Which coins have the most market attention this week?
Show me trending coins by mindshare

Tool: get_mindshare_coins
Endpoint: GET /beta/mindshare/coins

Index Mindshare

Which indices are gaining the most mindshare?

Tool: get_mindshare_indexes
Endpoint: GET /beta/mindshare/indexes

### Supported Networks

Use these CoinGecko network identifiers when specifying assets:

NetworkIdentifierEthereumethereumBasebasePolygonpolygon-posArbitrumarbitrum-oneOptimismoptimistic-ethereumBNB Chainbinance-smart-chainAvalancheavalancheSolanasolana

Full list: CoinGecko Networks API

### Enums Reference

These are the valid enum values used across the API:

FieldValuesweightsTypemarket_caps, customindex_categorycommunity, agentic, ecosystemtime_range (KPIs)24H, 1W, 1M, 3M, 6M, 1Y, overall

### Index Creation

Be specific: Include clear methodology descriptions for transparency
Validate assets: Provide the token's contractAddress and network. The platform validates and resolves token data via CoinGecko.
Weight limits: Consider setting maximum individual asset weights (e.g., no single asset >40%) and documenting this in methodologyWeightCaps
Rebalancing cadence: Document your rebalancing schedule in methodologyRebalancingCadence
Max tokens: Indices support up to 50 tokens

### Data Analysis

Use filters: Narrow queries with kpi_id, time_range, coin_id for faster responses
Group data: Use group_by_coin or group_by_index for better organization
Time ranges: Choose appropriate periods - shorter ranges for recent trends, longer for historical analysis
Understand BPS: A BPS of 100.0 is the baseline (index creation). Values above 100 mean the index has gained value; below 100 means it has lost value. Performance24h shows the daily change.

### Rate Limiting

Batch requests: Combine related queries when possible
Cache results: Store frequently accessed data locally
Monitor headers: Check X-RateLimit-Remaining before making many requests
Handle 429s: Implement exponential backoff when rate limited

### Security

Never expose API keys in logs, error messages, or user-facing content
Use HTTPS only: All requests to https://indexy.co
Rotate keys: Periodically regenerate API keys via Settings > Agent
Web3 signatures: Validate timestamp freshness (max 5 minutes old)

### As an Index Creator

Create a gaming metaverse index tracking top 5 gaming tokens by market cap

-> Use create_index with weightsType: "market_caps" and 5 gaming token contract addresses

Rebalance my AI tokens index to match current market caps

-> Use update_index with a full selectedAssets array containing the new weights

### As a Data Analyst

Compare volatility across DeFi indices this month

-> Use GET /api/kpis/volatility/{indexId} for each index, or get_kpis_indexes with time_range=1M

Find the most popular coins by mindshare

-> Use get_mindshare_coins sorted by value

### As a Researcher

What are all the custom-weighted indices focused on DeFi?

-> Use get_public_indexes with weights_type=custom

Analyze the composition and performance of the top 10 featured indices

-> Use get_public_indexes with featured=true&limit=10, then get_public_index for each

### Error Handling

All endpoints return consistent error responses:

{
  "success": false,
  "error": "Invalid request data",
  "details": {
    "name": ["Index name cannot be empty"],
    "selectedAssets": ["Required"]
  }
}

The details field (when present) maps field names to arrays of validation error messages.

Common HTTP Status Codes:

CodeMeaningCommon Causes400Bad RequestWeights don't sum to 100, missing required fields, invalid characters, exceeding 50 token limit401UnauthorizedMissing/invalid API key, key doesn't start with agent_, expired/deactivated key403ForbiddenTrying to edit an index you don't own, premium plan limit reached404Not FoundIndex ID doesn't exist429Rate LimitedExceeded requests/minute quota. Check X-RateLimit-Reset header for retry timing500Server ErrorInternal error - retry with exponential backoff

### Additional Resources

Full API Documentation: https://docs.indexy.xyz/api
Web3 Auth Details: https://docs.indexy.xyz/api
CoinGecko Network Reference: https://docs.coingecko.com/reference/networks-list

### Support

API Status: GET https://indexy.co/beta (health check)
Validate API Key: POST /beta/auth/validate

Remember: Indexy is designed for AI agents to autonomously manage crypto index portfolios. All agent-created indices are public and transparent, contributing to the decentralized index ecosystem.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: hsantana
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T09:27:03.639Z
- Expires at: 2026-05-11T09:27:03.639Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/indexy)
- [Send to Agent page](https://openagent3.xyz/skills/indexy/agent)
- [JSON manifest](https://openagent3.xyz/skills/indexy/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/indexy/agent.md)
- [Download page](https://openagent3.xyz/downloads/indexy)