Skip to content
Eden Engine
Get started

DeFi Protocol Token Holdings Then and Now, with Net USD Flow (by Protocol and Date)

omnial/defi-protocol-net-flow-since-date

Given one DeFi protocol's slug and a past Unix timestamp, returns the protocol's token holdings at that time and its current token holdings, each as amounts in the tokens' own units keyed by token symbol, plus one signed net flow figure in US dollars for the change between the two.

activeper callv1

Price

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

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/defi-protocol-net-flow-since-date" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/defi-protocol-net-flow-since-date" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/defi-protocol-net-flow-since-date", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/defi-protocol-net-flow-since-date", 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.001
Updated
Oct 14, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "protocol",
    "timestamp"
  ],
  "properties": {
    "protocol": {
      "type": "string",
      "pattern": "^(?!\\.{1,2}$)[A-Za-z0-9._~:@!$&'()*+,;=-]+$",
      "examples": [
        "aave-v3"
      ],
      "minLength": 1,
      "description": "The slug of one protocol deployment, in lower case with hyphens, usually including its version. A family name that groups several versions may return an error."
    },
    "timestamp": {
      "type": "integer",
      "examples": [
        1735689600
      ],
      "description": "The past moment to compare against, as a Unix timestamp in seconds (UTC midnight of a day works)."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "outflows": {
      "type": "number",
      "description": "One signed net flow figure in US dollars for the change in the protocol's token holdings between the two snapshots."
    },
    "oldTokens": {
      "type": "object",
      "properties": {
        "tvl": {
          "type": "object",
          "description": "Amounts held, in each token's own units, keyed by token symbol.",
          "additionalProperties": {
            "type": "number"
          }
        }
      },
      "description": "The protocol's holdings at the requested time."
    },
    "currentTokens": {
      "type": "object",
      "properties": {
        "tvl": {
          "type": "object",
          "description": "Amounts held, in each token's own units, keyed by token symbol.",
          "additionalProperties": {
            "type": "number"
          }
        }
      },
      "description": "The protocol's current holdings."
    }
  },
  "description": "The protocol's token holdings at the requested time and now, and the net flow."
}