Skip to content
Eden Engine

Token Price History by Symbol and Time Window

omnial/market-price

Given a token ticker symbol, an optional time window and quote currency, returns a time series of historical price points for that window plus summary stats -- first, last, high, low, and absolute and percent change over the period.

activeper callv3

Price

Up to $0.0164 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

CoinGecko

Data from CoinGecko.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/market-price" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/market-price" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/market-price", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/market-price", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0164
Updated
Oct 27, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "End of custom date range (Unix timestamp or YYYY-MM-DD). Must be used together with from. Overrides time_range when set. Example: 2025-03-01."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Start of custom date range (Unix timestamp or YYYY-MM-DD). Must be used together with to. Overrides time_range when set. Example: 2025-01-01."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Single token ticker symbol like BTC, ETH, or SOL (multi-symbol not supported). Example: BTC."
    },
    "currency": {
      "type": "string",
      "default": "usd",
      "minLength": 1,
      "description": "Quote currency like usd, eur, or btc. Example: usd. Defaults to \"usd\"."
    },
    "time_range": {
      "enum": [
        "1d",
        "7d",
        "14d",
        "30d",
        "90d",
        "180d",
        "365d",
        "max"
      ],
      "type": "string",
      "default": "30d",
      "description": "Window of historical data to return: 1d, 7d, 14d, 30d, 90d, 180d, 365d, or max. Ignored when from/to are set. This endpoint uses time_range only — it does NOT accept interval; bucket granularity is chosen server-side based on the window size. Example: 30d. Defaults to \"30d\"."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "description": "The price at this timestamp, in the requested quote currency."
          },
          "metric": {
            "type": "string",
            "description": "The kind of value this point reports. Typically \"price\"; other values are not documented."
          },
          "symbol": {
            "type": "string",
            "description": "Echoes the requested token ticker symbol."
          },
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds for this price point."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per historical price point, typically oldest first."
    },
    "meta": {
      "type": "object",
      "properties": {
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache."
        }
      },
      "additionalProperties": false
    },
    "symbol": {
      "type": "string",
      "description": "Echoes the requested token ticker symbol."
    },
    "summary": {
      "type": "object",
      "properties": {
        "low": {
          "type": "number",
          "description": "Lowest value observed in the window."
        },
        "high": {
          "type": "number",
          "description": "Highest value observed in the window."
        },
        "last": {
          "type": "number",
          "description": "Value of the most recent point in the window."
        },
        "first": {
          "type": "number",
          "description": "Value of the earliest point in the window."
        },
        "n_points": {
          "type": "integer",
          "description": "Number of data points in data[] for this call."
        },
        "latest_dt": {
          "type": "integer",
          "description": "Unix seconds of the most recent data point."
        },
        "change_abs": {
          "type": "number",
          "description": "Absolute change from first to last."
        },
        "change_pct": {
          "type": "number",
          "description": "Percent change from first to last."
        }
      },
      "description": "Aggregate stats over the returned data points.",
      "additionalProperties": false
    }
  },
  "description": "The market price response.",
  "additionalProperties": false
}