---
name: evmapi.x402.fi
description: evmapi.x402.fi provides two EVM-focused data skills: one for fetching the current USD price of a token by contract address on a specified chain, and one for retrieving a directory of supported EVM tokens with their on-chain metadata. Together they cover token discovery and spot pricing for EVM-compatible networks.
host: evmapi.x402.fi
---

# evmapi.x402.fi

evmapi.x402.fi is a lightweight EVM data host serving agents that need token metadata lookup and current USD pricing on EVM chains. It targets use cases like portfolio valuation, integration configuration, and token display — not trading execution or historical analysis. It covers only EVM-compatible networks and does not support Solana, Bitcoin, or other non-EVM chains.

## When to use this host

Use evmapi.x402.fi when an agent needs current USD spot prices or on-chain metadata for tokens on EVM-compatible chains. It is appropriate for portfolio valuation, token display, and integration setup. Do not use it for historical price data or OHLCV series — use a dedicated time-series price API instead. Do not use it for swap quotes or DEX routing — use a DEX quote API instead. It does not support non-EVM chains such as Solana or Bitcoin; use chain-specific APIs for those networks.

## Capabilities

### Token Discovery and Metadata

Provides a full directory of supported EVM tokens with on-chain metadata including symbol, decimals, network identifier, fee payer address, and API ID, enabling token lookup and integration configuration.

- **`fetch-evm-token-list-with-details`** — Returns a list of EVM tokens with metadata including symbol, decimals, network, feePayer, and API ID for integration use.

### Spot Price Feed

Returns the current USD price for a specific EVM token by contract address on a given chain, supporting portfolio valuation and price display.

- **`fetch-evm-token-price`** — Returns the current USD price for a given token address on a specified EVM-compatible chain.

## Workflows

### Token Lookup and Price Resolution

*Use when an agent needs to resolve a token's metadata and then fetch its current USD price, for example when only a symbol is known and the contract address must be looked up first.*

1. **`fetch-evm-token-list-with-details`** — Retrieve the token directory to find the contract address and network identifier for the target token by symbol or API ID.
2. **`fetch-evm-token-price`** — Use the resolved contract address and chain identifier to fetch the current USD spot price for that token.

## Skill reference

### `fetch-evm-token-price`

**EVM Token Price** — Returns the current USD price for a given token address on a specified EVM-compatible chain.

*Use when:* Use when an agent needs the USD price of a specific EVM token by contract address on a supported chain, such as for portfolio valuation, trade sizing, or price display.

*Not for:* Do not use for historical price data or OHLCV series; use a time-series price API instead. Not suitable for non-EVM chains such as Solana or Bitcoin.

**Inputs:**

- `chain` (string, required) — EVM chain identifier used as a path parameter to specify which blockchain to query (e.g. a chain name or ID supported by the API).
- `tokenAddress` (string, required) — EVM contract address of the token whose USD price is being requested, used as a path parameter.

**Returns:** Returns the USD price of the specified EVM token on the given chain as a numeric value.

**Example:** `GET https://evmapi.x402.fi/base/tokenPrice/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

---

### `fetch-evm-token-list-with-details`

**EVM Token Details Feed** — Returns a list of EVM tokens with metadata including symbol, decimals, network, feePayer, and API ID for integration use.

*Use when:* Use when an agent needs a comprehensive directory of EVM tokens with their on-chain metadata (symbol, decimals, network identifier, fee payer address, and API ID) to support token lookup, integration configuration, or display purposes.

*Not for:* Do not use for real-time token prices or swap quotes; use a DEX quote API instead. Not suitable for non-EVM chains.

**Returns:** Returns an array of EVM token objects each containing asset address, symbol, decimals, network (CAIP-2), feePayer address, and apiId.

**Example:** `GET https://evmapi.x402.fi/tokenListWithDetails`

---