# CoinGecko On-Chain ETH Token Price (USDT / 0xdac17f)

> CoinGecko On-Chain ETH Token Price (USDT / 0xdac17f) is a paid API for AI agents from pro-api.coingecko.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the current on-chain price for the USDT ERC-20 token on Ethereum by its contract address (0xdac17f958d2ee523a2206206994597c13d831ec7).

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xdac17f958d2ee523a2206206994597c13d831ec7
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pro-api-coingecko-com-614b3883
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mUyIRs89DdTsV7gYKbas7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pro-api-coingecko-com-614b3883
```

Example prompt: What's the current on-chain price of USDT on Ethereum right now, and can you also include the 24-hour price change and market cap?

## When to prefer this

Use this endpoint when you specifically need the on-chain price of USDT (or the ERC-20 token at 0xdac17f958d2ee523a2206206994597c13d831ec7) on the Ethereum network, sourced directly from on-chain DEX data via CoinGecko Pro. Prefer this over CoinGecko's off-chain simple price endpoint when you need DEX-sourced pricing, or when you need on-chain market metrics like total reserve in USD. This is especially useful for DeFi applications, arbitrage monitoring, or any workflow requiring verifiable on-chain price feeds for Ethereum tokens.

## Known failure modes

- Invalid or unsupported contract address returns 404 or empty result
- Missing or invalid API key returns 401 unauthorized
- Rate limit exceeded returns 429 too many requests
- Network congestion or upstream data lag may cause stale price data
- Payment not processed (x402 protocol failure) returns 402 payment required

## How this service works

Returns the current on-chain price for a specified ERC-20 token on Ethereum by contract address (e.g., USDT 0xdac17f...).

## Output

Returns a JSON object containing the current on-chain price of the token (USDT at 0xdac17f958d2ee523a2206206994597c13d831ec7) on Ethereum, optionally including 24hr volume, market cap, 24hr price change, total reserve in USD, and data from inactive sources depending on query parameters supplied.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "include_24hr_vol": true,
   "include_market_cap": true,
   "include_24hr_price_change": true
  }
 },
 "output": {
  "type": "object",
  "example": {
   "0xdac17f958d2ee523a2206206994597c13d831ec7": {
    "eth": 1,
    "eth_24h_vol": 500000000,
    "eth_24h_change": 0.5,
    "eth_market_cap": 85000000000
   }
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "include_24hr_vol": {
       "type": "boolean"
      },
      "mcap_fdv_fallback": {
       "type": "boolean"
      },
      "include_market_cap": {
       "type": "boolean"
      },
      "include_inactive_source": {
       "type": "boolean"
      },
      "include_24hr_price_change": {
       "type": "boolean"
      },
      "include_total_reserve_in_usd": {
       "type": "boolean"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "id",
    "type",
    "attributes"
   ],
   "properties": {
    "id": {
     "type": "string"
    },
    "type": {
     "type": "string"
    },
    "attributes": {
     "type": "object",
     "required": [
      "token_prices",
      "h24_volume_usd",
      "market_cap_usd",
      "h24_price_change_percentage"
     ],
     "properties": {
      "token_prices": {
       "type": "object",
       "required": [
        "0xdac17f958d2ee523a2206206994597c13d831ec7"
       ],
       "properties": {
        "0xdac17f958d2ee523a2206206994597c13d831ec7": {
         "type": "string"
        }
       }
      },
      "h24_volume_usd": {
       "type": "object",
       "required": [
        "0xdac17f958d2ee523a2206206994597c13d831ec7"
       ],
       "properties": {
        "0xdac17f958d2ee523a2206206994597c13d831ec7": {
         "type": "string"
        }
       }
      },
      "market_cap_usd": {
       "type": "object",
       "required": [
        "0xdac17f958d2ee523a2206206994597c13d831ec7"
       ],
       "properties": {
        "0xdac17f958d2ee523a2206206994597c13d831ec7": {
         "type": "string"
        }
       }
      },
      "h24_price_change_percentage": {
       "type": "object",
       "required": [
        "0xdac17f958d2ee523a2206206994597c13d831ec7"
       ],
       "properties": {
        "0xdac17f958d2ee523a2206206994597c13d831ec7": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pro-api-coingecko-com-614b3883/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pro-api.coingecko.com](https://www.zero.xyz/host/pro-api.coingecko.com/llms.txt)