ForceX

Chain

Litecoin address transactions

get_chain_address_transactions · Chain · 5 credits

Use this when the user asks for an address's full transaction history. Paginated transaction history for an address. 5 credits per page. Use `cursor` to page; `limit`/`direction` optional. Free keys are bounded to a shallow cursor depth and page size; paid keys page deeper.

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_chain_address_transactions",
    "arguments": {
      "chain": "litecoin",
      "address": "<litecoin address>"
    }
  }
}

Parameters

NameTypeRequiredDescription
addressstringyesLitecoin address to look up. Formats: bech32 (ltc1...), legacy base58 (L.../M...), or P2SH (3.../M...). Advisory only — the route validates authoritatively.
chainstring — one of: litecoinyesBlockchain network. Currently litecoin.
cursorstringnoPagination cursor from the previous response.
directionstring — one of: in, out, bothnoFilter by direction: in, out, or both (default both).
limitintegernoRows per page (1-100, default 25; Free-tier effective clamp 20).
Full input schema
{
  "additionalProperties": false,
  "properties": {
    "address": {
      "description": "Litecoin address to look up. Formats: bech32 (ltc1...), legacy base58 (L.../M...), or P2SH (3.../M...). Advisory only — the route validates authoritatively.",
      "type": "string"
    },
    "chain": {
      "description": "Blockchain network. Currently `litecoin`.",
      "enum": [
        "litecoin"
      ],
      "type": "string"
    },
    "cursor": {
      "description": "Pagination cursor from the previous response.",
      "type": "string"
    },
    "direction": {
      "default": "both",
      "description": "Filter by direction: in, out, or both (default both).",
      "enum": [
        "in",
        "out",
        "both"
      ],
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "Rows per page (1-100, default 25; Free-tier effective clamp 20).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "chain",
    "address"
  ],
  "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"
    },
    "data": {
      "items": {
        "additionalProperties": true,
        "properties": {
          "block_height": {
            "type": "integer"
          },
          "block_time": {
            "type": "string"
          },
          "direction": {
            "type": "string"
          },
          "has_mweb": {
            "type": "boolean"
          },
          "is_coinbase": {
            "type": "boolean"
          },
          "is_hogex": {
            "type": "boolean"
          },
          "txid": {
            "type": "string"
          },
          "value_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 address transactions result",
  "type": "object"
}

Notes

  • Cost: 5 credits. Costs and tier limits match the wrapped Xtract REST endpoint — see get_developer_limits.
  • Wrapped REST endpoint: /xtract/docs/reference/chain-address-transactions/ — 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.