Token Earliest Recorded Price (by Chain and Contract Address)

omnial/token-earliest-recorded-price

For one or more tokens, each given as chain and contract address, returns the earliest price on record for each token in US dollars, with the token's symbol and the Unix timestamp of that first price, keyed by the token as it was requested.

activeper callv1

Price

$0.001 per call

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

DefiLlama

Data from DefiLlama.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

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

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/token-earliest-recorded-price", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/token-earliest-recorded-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.

Charge	Price
Per call	$0.001

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "coins"
  ],
  "properties": {
    "coins": {
      "type": "string",
      "pattern": "^(?!\\.{1,2}$)[A-Za-z0-9._~:@!$&'()*+,;=-]+$",
      "maxLength": 1000,
      "minLength": 1,
      "description": "One or more tokens, comma-separated, each written as chain:contractAddress (the chain name in lower case, such as ethereum or bsc, a colon, then the token's contract address)."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "coins": {
      "type": "object",
      "description": "The requested tokens' entries, each keyed by the token exactly as it was requested (chain:contractAddress).",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "price": {
            "type": "number",
            "description": "The earliest recorded price, in US dollars."
          },
          "symbol": {
            "type": "string",
            "description": "The token's ticker symbol."
          },
          "timestamp": {
            "type": "number",
            "description": "When that price was recorded, as a Unix timestamp in seconds."
          }
        }
      }
    }
  },
  "description": "The earliest recorded price of each requested token."
}