---
name: api.aimo.xyz
description: api.aimo.xyz provides two skills for cryptocurrency research: one for resolving coin names or ticker symbols to CoinGecko IDs, and one for fetching a formatted market data snapshot (price, 24h change, volume, market cap, ATH) for a given asset. Both skills draw from CoinGecko data and return human-readable text rather than structured machine-parseable fields.
host: api.aimo.xyz
---

# api.aimo.xyz

This host serves agents that need lightweight, read-only cryptocurrency lookup and market summary capabilities backed by CoinGecko. It is suited for informational or conversational use cases where a pre-formatted text response is acceptable. It does not support trading, streaming feeds, bulk queries, or structured data output for programmatic consumption.

## When to use this host

Use this host when an agent needs to look up a cryptocurrency by name or symbol and retrieve a human-readable market summary for informational or conversational purposes. The two-step workflow (search then fetch) is appropriate when the CoinGecko ID is not already known. Do not use this host when structured, machine-parseable price data is required for trading logic or programmatic processing — use a raw market data API (e.g., CoinGecko's direct REST API or a dedicated financial data provider) instead. Not suitable for bulk coin listings, streaming price feeds, historical OHLCV data, or portfolio-level analytics.

## Capabilities

### Coin Identity Resolution

Resolves a coin name or ticker symbol to its CoinGecko ID and associated metadata, enabling downstream lookups by canonical identifier.

- **`search-coins`** — Searches cryptocurrency coins and tokens by name or symbol and returns matching CoinGecko IDs and metadata for up to a specified number of results.

### Market Data Snapshot

Fetches a formatted summary of a crypto asset's current price, 24h change, 24h range, volume, market cap, and all-time high from CoinGecko.

- **`fetch-crypto-asset-info`** — Returns a formatted text summary of a cryptocurrency asset's current price, 24h change, 24h range, volume, market cap, and all-time high via CoinGecko data.

## Workflows

### Symbol-to-Market-Summary Lookup

*Use when an agent receives an ambiguous coin name or ticker and needs to resolve it to a CoinGecko ID before fetching its market statistics.*

1. **`search-coins`** — Search by the coin name or ticker to obtain the canonical CoinGecko ID for the target asset.
2. **`fetch-crypto-asset-info`** — Pass the resolved CoinGecko ID (and ticker) to retrieve a formatted market data snapshot including price, 24h change, volume, market cap, and ATH.

## Skill reference

### `search-coins`

**Aimo CoinSearch** — Searches cryptocurrency coins and tokens by name or symbol and returns matching CoinGecko IDs and metadata for up to a specified number of results.

*Use when:* Use when an agent needs to resolve a coin name or ticker symbol to its CoinGecko ID, or discover coins matching a search term before fetching price or market data.

*Not for:* Do not use for real-time price lookups or market data — this returns identifiers and metadata only, not pricing. Not suitable for listing all coins without a search term.

**Inputs:**

- `query` (string, required) — Search term to match against coin names or symbols.
- `limit` (integer) — Maximum number of results to return. Defaults to 10.
- `include_platform` (boolean) — Whether to include platform/contract address information in results. Defaults to false.

**Returns:** Returns a formatted string listing up to N matching coins, each with display name, ticker symbol, and CoinGecko ID.

**Example:** `{"query": "solana", "limit": 10}`

---

### `fetch-crypto-asset-info`

**CryptoAsset Insights** — Returns a formatted text summary of a cryptocurrency asset's current price, 24h change, 24h range, volume, market cap, and all-time high via CoinGecko data.

*Use when:* Use when an agent needs a quick snapshot of a crypto asset's key market statistics (price, 24h change, volume, market cap, ATH) and can accept a pre-formatted text response rather than structured fields.

*Not for:* Do not use when structured/machine-parseable price data is required (e.g., for programmatic trading logic); use a raw market data API instead. Not suitable for bulk or streaming price feeds.

**Inputs:**

- `ticker` (string) — Display ticker symbol for the asset (e.g., 'BTC', 'ETH'). At least one of ticker or coingeckoId should be provided.
- `coingeckoId` (string) — CoinGecko coin ID for the asset (e.g., 'bitcoin', 'ethereum', 'solana'). At least one of ticker or coingeckoId should be provided.

**Returns:** Returns a single 'result' string with BTC's last price, 24h change, 24h range, 24h volume, market cap, and ATH formatted as a human-readable text block.

**Example:** `{"ticker": "BTC", "coingeckoId": "bitcoin"}`

---