Charts

Litecoin economic-flow chart

get_charts_economic_flow · Charts · 6 credits

Use this when the user asks about on-chain economic volume DATA over a date range — returns the underlying series values, not a rendered chart. Economic-flow series over [start,end). 6 credits (methodology product). `grain` day|week|month|year. Values are LTC atomic units (litoshi); adjusted_volume_usd is served for completed history with complete observed-candle coverage (methodology usd_v1_daily_close_observed: daily observed USD close per day, buckets sum the converted days; a bucket missing any observed candle is null — never interpolated or partial; chiefly pre-2018 history). USD only — no EUR/BTC conversion. The current in-progress economic-flow object remains atomic-unit-only. Request a bounded range.

All MCP Tools Connect AI Tools

Page Sections

Request

Send a tools/call request to the MCP endpoint /xtract/mcp:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_charts_economic_flow",
    "arguments": {
      "chain": "litecoin",
      "start": "2026-06-20",
      "end": "2026-06-27"
    }
  }
}

Parameters

Name	Type	Required	Description
`chain`	string — one of: litecoin	yes	Blockchain network. Currently `litecoin`.
`end`	string	yes	Range end (excluded): ISO date (YYYY-MM-DD) or ISO-8601 Z timestamp. Required.
`grain`	string — one of: day, week, month, year	no	Time bucket: day, week, month, or year.
`include_current`	boolean	no	Attach live current data (in-progress window / state snapshots). MCP DEFAULTS THIS TRUE for chart tools; pass false explicitly to receive the pre-change response with no `current` key.
`methodology`	string	no	Optional methodology id. Default (and only registered id today): v3_ch_flow_interval. Unknown ids are rejected (400 methodology_unknown) BEFORE any charge.
`start`	string	yes	Range start: ISO date (YYYY-MM-DD) or ISO-8601 Z timestamp. Ranges are half-open [start,end) — end excluded. Required. Max span per grain: day 731d, week 1827d, month 3653d, year 7305d.

Full input schema

{
  "additionalProperties": false,
  "properties": {
    "chain": {
      "description": "Blockchain network. Currently `litecoin`.",
      "enum": [
        "litecoin"
      ],
      "type": "string"
    },
    "end": {
      "description": "Range end (excluded): ISO date (YYYY-MM-DD) or ISO-8601 Z timestamp. Required.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2})?Z?)?$",
      "type": "string"
    },
    "grain": {
      "default": "day",
      "description": "Time bucket: day, week, month, or year.",
      "enum": [
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    },
    "include_current": {
      "description": "Attach live current data (in-progress window / state snapshots). MCP DEFAULTS THIS TRUE for chart tools; pass false explicitly to receive the pre-change response with no `current` key.",
      "type": "boolean"
    },
    "methodology": {
      "description": "Optional methodology id. Default (and only registered id today): v3_ch_flow_interval. Unknown ids are rejected (400 methodology_unknown) BEFORE any charge.",
      "type": "string"
    },
    "start": {
      "description": "Range start: ISO date (YYYY-MM-DD) or ISO-8601 Z timestamp. Ranges are half-open [start,end) — end excluded. Required. Max span per grain: day 731d, week 1827d, month 3653d, year 7305d.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2})?Z?)?$",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "start",
    "end"
  ],
  "type": "object"
}

Response

The outputSchema is the CLOSED model contract for structuredContent (top-level additionalProperties: false), answer-first fixed key order: source, tool, endpoint, request (echoed arguments), answer (authoritative result summary — answer from this and data), data (the complete result), included/included_digest (full expansion rows + a compact digest, when paid include expansions were served), units, answerable_fields, warnings, citations (complete visible citation array), usage (per-call cost truth), validation, and pagination (cursor/has_more/effective_limit/requested_limit). The single content block is a short plain-text answer card mirroring the same facts (header, Answer, Units, Warnings, Usage, Source). Errors return a plain-text error card and attach NO structuredContent. See How to cite ForceX MCP results.

Full output schema

{
  "additionalProperties": false,
  "description": "Answer-first model contract: source, tool, endpoint, request, answer, data, included?, included_digest?, units, answerable_fields, warnings, citations, usage, validation, pagination?. Errors attach NO structuredContent (plain-text error card in content).",
  "properties": {
    "answer": {
      "description": "Authoritative result summary — answer from this and `data`.",
      "type": "string"
    },
    "answerable_fields": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "citations": {
      "items": {
        "additionalProperties": true,
        "description": "Visible citation (optional keys null-elided).",
        "properties": {
          "docs_url": {
            "type": "string"
          },
          "endpoint": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "tool": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "tool",
          "endpoint",
          "docs_url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "current": {
      "additionalProperties": false,
      "description": "Live current data (1_live_statistics): in-progress window and/or state snapshots with as-of provenance. A current partial is NEVER a completed close.",
      "properties": {
        "lag_blocks": {
          "type": [
            "integer",
            "null"
          ]
        },
        "snapshots": {
          "items": {
            "additionalProperties": false,
            "description": "Point-in-time state (never summed; no interval semantics). Chain-derived snapshots carry height/hash/time + stability; non-chain sources carry source_watermark.",
            "properties": {
              "as_of_hash": {
                "type": "string"
              },
              "as_of_height": {
                "type": "integer"
              },
              "as_of_time": {
                "type": "string"
              },
              "confirmation_depth": {
                "type": "integer"
              },
              "kind": {
                "enum": [
                  "state_snapshot"
                ],
                "type": "string"
              },
              "last_complete_at": {
                "type": "string"
              },
              "reason_code": {
                "type": "string"
              },
              "scope": {
                "type": "string"
              },
              "source_watermark": {
                "type": "string"
              },
              "stability": {
                "enum": [
                  "provisional",
                  "reorg_safe"
                ],
                "type": "string"
              },
              "status": {
                "enum": [
                  "available",
                  "unavailable"
                ],
                "type": "string"
              },
              "values": {
                "description": "Snapshot values. Big-integer policy: cumulative_output_value_atomic_units is ALWAYS a decimal string (it exceeds 64-bit integer range); treat it as an exact integer, never a float.",
                "properties": {
                  "cumulative_output_value_atomic_units": {
                    "pattern": "^[0-9]+$",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            },
            "required": [
              "kind",
              "status"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "validated_height": {
          "type": [
            "integer",
            "null"
          ]
        },
        "window": {
          "additionalProperties": false,
          "description": "In-progress or completed calendar/rolling interval with explicit as-of provenance. Half-open [window_start, window_end); is_complete via the median-time-past predicate; stability is reorg-canonicality, orthogonal to completeness.",
          "properties": {
            "aggregation": {
              "type": "string"
            },
            "as_of_hash": {
              "type": "string"
            },
            "as_of_height": {
              "type": "integer"
            },
            "as_of_time": {
              "type": "string"
            },
            "classifier_lag_blocks": {
              "type": "integer"
            },
            "confirmation_depth": {
              "type": "integer"
            },
            "granularity": {
              "enum": [
                "day",
                "week",
                "month",
                "year",
                "rolling_24h"
              ],
              "type": "string"
            },
            "is_complete": {
              "type": "boolean"
            },
            "kind": {
              "enum": [
                "time_window"
              ],
              "type": "string"
            },
            "last_complete_at": {
              "type": "string"
            },
            "methodology_version": {
              "type": "string"
            },
            "observation_count": {
              "type": "integer"
            },
            "reason_code": {
              "type": "string"
            },
            "stability": {
              "enum": [
                "provisional",
                "reorg_safe"
              ],
              "type": "string"
            },
            "status": {
              "enum": [
                "available",
                "unavailable"
              ],
              "type": "string"
            },
            "values": {
              "type": "object"
            },
            "window_end": {
              "type": "string"
            },
            "window_start": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "status"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "snapshots"
      ],
      "type": "object"
    },
    "data": {
      "items": {
        "additionalProperties": true,
        "properties": {
          "adjusted_volume_atomic_units": {
            "type": "integer"
          },
          "date": {
            "type": "string"
          },
          "total_volume_atomic_units": {
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "endpoint": {
      "type": "string"
    },
    "pagination": {
      "type": [
        "object",
        "null"
      ]
    },
    "request": {
      "type": "object"
    },
    "source": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "units": {
      "type": "object"
    },
    "usage": {
      "additionalProperties": true,
      "description": "Per-call cost truth; cost_note only when the charge exceeds the Free cap.",
      "properties": {
        "base_credit_cost": {
          "type": "integer"
        },
        "credit_cost": {
          "type": [
            "integer",
            "null"
          ]
        },
        "include_credit_costs": {
          "type": "object"
        },
        "rate_limit": {
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "credit_cost",
        "base_credit_cost",
        "include_credit_costs"
      ],
      "type": "object"
    },
    "validation": {
      "additionalProperties": false,
      "description": "Validation state; not_applicable_reason when not chain-scope.",
      "properties": {
        "lag_blocks": {
          "type": [
            "integer",
            "null"
          ]
        },
        "not_applicable_reason": {
          "type": "string"
        },
        "scope": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "type": [
            "string",
            "null"
          ]
        },
        "validated_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "validated_height": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "status"
      ],
      "type": "object"
    },
    "warnings": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "source",
    "tool",
    "endpoint",
    "request",
    "answer",
    "data",
    "units",
    "answerable_fields",
    "warnings",
    "citations",
    "usage",
    "validation"
  ],
  "title": "Litecoin economic-flow chart result",
  "type": "object"
}

Notes

Cost: 6 credits. Costs and tier limits match the wrapped Xtract REST endpoint — see get_developer_limits.
Wrapped REST endpoint: /xtract/docs/reference/charts-economic-flow/ — the full parameter, response, and methodology reference.
Data-retrieval tool: it never creates blockchain transactions, signs messages, publishes content, or changes third-party state (openWorldHint=false, destructiveHint=false). Successful calls consume Xtract credits and record usage on your ForceX account, so readOnlyHint=false.