Skip to main content
Glama
pulse-verity

pulse-verity

Get Pulse Verity Index History

get_index_history
Read-onlyIdempotent

Fetch paginated crypto index history with OHLC candles, summary metrics, and signed observations, so agents can inspect price records and verify individual prints.

Instructions

Read one page of index history for a crypto symbol from /api/index/v1/history: candles (open, high, low, close per interval), summary metrics, pagination and, for dataset=verified, verifiedObservations. dataset=verified (default) is built from prints Pulse calculated and signed live; dataset=reconstructed is rebuilt history, not signed at the historical time, served at interval 1h or 1d. Candles, metrics and surrounding metadata are unsigned. Each verifiedObservations row carries symbol, price (the exact signed text), at, grade, signature and kid; pass those fields to verify_print to check a row, which authenticates its price fields only (history rows carry no v2 block). A null kid can be passed as it is or left out; a row whose signature or grade is null cannot be verified. The account's plan sets how far back history reaches: when the request started earlier, rangeClamped is true and from is where the page begins. limit (1 to 1000, default 200) bounds the rows on one page. For dataset=verified at interval 1h or 1d it is at most 250: a page there can count hours, and each hour can carry up to four signed prints (open, high, low and close), so verifiedObservations can hold up to four rows per hour. For the next page pass pagination.nextCursor as cursor with the same symbol, dataset and interval. from and to are ISO-8601 times; the default window is the 30 days before to. Pass assetId, written as the server issues it (native::, or contract:: such as contract:eip155:1:0x...), when a symbol identifies more than one asset. Needs a developer key (PULSE_API_KEY) or the hosted server.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "symbol": "<symbol>"
    },
    "name": "get_index_history"
  }
}

Input Schema

NameRequiredDescriptionDefault
toNoEnd of the window, ISO-8601; defaults to now
fromNoStart of the window, ISO-8601
limitNoRows on one page; at most 250 for dataset=verified at interval 1h or 1d
cursorNopagination.nextCursor from the previous page
symbolYesCrypto ticker symbol, e.g. BTC, ETH, SOL
assetIdNoCanonical asset identity as the server issues it, e.g. native:pulse-verity:btc or contract:eip155:1:0x...; only when a symbol identifies more than one asset
datasetNoverified (default): prints Pulse signed live; reconstructed: rebuilt history at 1h or 1d, not signed at the timeverified
intervalNoCandle size: 1m, 5m, 1h (default) or 1d1h

Output Schema

NameRequiredDescriptionDefault
toNo
fromNo
noteNo
assetNo
errorNo
symbolNo
candlesNo
datasetNo
metricsNo
successNo
intervalNo
requestIdYesIdentifier for this MCP call; not a signed price field.
paginationNo
provenanceNo
rangeClampedNo
identityBindingNo
verifiedArchiveSinceNo
verifiedObservationsNo
contemporaneouslySignedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed80 schema fields changedv1.3.7
    • removedInput schema / additionalProperties
      Removed value: -false
    • addedInput schema / properties / dataset / description
      Added value: +"verified (default): prints Pulse signed live; reconstructed: rebuilt history at 1h or 1d, not signed at the time"
    • addedInput schema / properties / interval / description
      Added value: +"Candle size: 1m, 5m, 1h (default) or 1d"
    • removedInput schema / properties / to / $ref
      Removed value: -"#/properties/from"
    • addedInput schema / properties / to / maxLength
      Added value: +40
    • addedInput schema / properties / to / pattern
      Added value: +"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$"
    • addedInput schema / properties / to / type
      Added value: +"string"
    • removedOutput schema / properties / candles / items / properties / at / $ref
      Removed value: -"#/properties/from"
    • addedOutput schema / properties / candles / items / properties / at / maxLength
      Added value: +40
    • addedOutput schema / properties / candles / items / properties / at / type
      Added value: +"string"
    • removedOutput schema / properties / candles / items / properties / close / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum/anyOf/0"
    • addedOutput schema / properties / candles / items / properties / close / type
      Added value: +"number"
    • removedOutput schema / properties / candles / items / properties / confidence / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum/anyOf/0"
    • addedOutput schema / properties / candles / items / properties / confidence / type
      Added value: +"number"
    • removedOutput schema / properties / candles / items / properties / coverage / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum/anyOf/0"
    • addedOutput schema / properties / candles / items / properties / coverage / type
      Added value: +"number"
    • removedOutput schema / properties / candles / items / properties / high / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum/anyOf/0"
    • addedOutput schema / properties / candles / items / properties / high / type
      Added value: +"number"
    • removedOutput schema / properties / candles / items / properties / low / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum/anyOf/0"
    • addedOutput schema / properties / candles / items / properties / low / type
      Added value: +"number"
    • removedOutput schema / properties / candles / items / properties / observations / $ref
      Removed value: -"#/properties/provenance/properties/signedObservations"
    • addedOutput schema / properties / candles / items / properties / observations / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / candles / items / properties / observations / minimum
      Added value: +0
    • addedOutput schema / properties / candles / items / properties / observations / type
      Added value: +"integer"
    • removedOutput schema / properties / candles / items / properties / open / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum/anyOf/0"
    • addedOutput schema / properties / candles / items / properties / open / type
      Added value: +"number"
    • removedOutput schema / properties / metrics / properties / annualizedVolatility / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum"
    • addedOutput schema / properties / metrics / properties / annualizedVolatility / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / metrics / properties / candleCount / $ref
      Removed value: -"#/properties/provenance/properties/signedObservations"
    • addedOutput schema / properties / metrics / properties / candleCount / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / metrics / properties / candleCount / minimum
      Added value: +0
    • addedOutput schema / properties / metrics / properties / candleCount / type
      Added value: +"integer"
    • removedOutput schema / properties / metrics / properties / maxDrawdown / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum"
    • addedOutput schema / properties / metrics / properties / maxDrawdown / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / metrics / properties / observationCount / $ref
      Removed value: -"#/properties/provenance/properties/signedObservations"
    • addedOutput schema / properties / metrics / properties / observationCount / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / metrics / properties / observationCount / minimum
      Added value: +0
    • addedOutput schema / properties / metrics / properties / observationCount / type
      Added value: +"integer"
    • removedOutput schema / properties / metrics / properties / periodReturn / $ref
      Removed value: -"#/properties/provenance/properties/coverage/anyOf/0/properties/minimum"
    • addedOutput schema / properties / metrics / properties / periodReturn / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • changedOutput schema / properties / pagination / properties / coverage / properties / availableFrom / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/properties/from"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 40,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / pagination / properties / coverage / properties / availableTo / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/properties/from"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 40,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / pagination / properties / coverage / properties / earliestReturnedAt / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/properties/from"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 40,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / pagination / properties / coverage / properties / latestReturnedAt / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/properties/from"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 40,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / pagination / properties / coverage / properties / requestedFrom / $ref
      Removed value: -"#/properties/from"
    • addedOutput schema / properties / pagination / properties / coverage / properties / requestedFrom / maxLength
      Added value: +40
    • addedOutput schema / properties / pagination / properties / coverage / properties / requestedFrom / type
      Added value: +"string"
    • removedOutput schema / properties / pagination / properties / coverage / properties / requestedTo / $ref
      Removed value: -"#/properties/from"
    • addedOutput schema / properties / pagination / properties / coverage / properties / requestedTo / maxLength
      Added value: +40
    • addedOutput schema / properties / pagination / properties / coverage / properties / requestedTo / type
      Added value: +"string"
    • removedOutput schema / properties / pagination / properties / coverage / properties / returned / $ref
      Removed value: -"#/properties/provenance/properties/signedObservations"
    • addedOutput schema / properties / pagination / properties / coverage / properties / returned / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / pagination / properties / coverage / properties / returned / minimum
      Added value: +0
    • addedOutput schema / properties / pagination / properties / coverage / properties / returned / type
      Added value: +"integer"
    • removedOutput schema / properties / pagination / properties / coverage / properties / unverifiableRows / $ref
      Removed value: -"#/properties/provenance/properties/signedObservations"
    • addedOutput schema / properties / pagination / properties / coverage / properties / unverifiableRows / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / pagination / properties / coverage / properties / unverifiableRows / minimum
      Added value: +0
    • addedOutput schema / properties / pagination / properties / coverage / properties / unverifiableRows / type
      Added value: +"integer"
    • removedOutput schema / properties / provenance / properties / confidence / $ref
      Removed value: -"#/properties/provenance/properties/coverage"
    • addedOutput schema / properties / provenance / properties / confidence / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "average": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "minimum": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "minimum",
      +      "average"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / provenance / properties / coverage / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "average": {
      -        "$ref": "#/properties/provenance/properties/coverage/anyOf/0/properties/minimum"
      -      },
      -      "minimum": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "minimum",
      -      "average"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "average": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "minimum": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "minimum",
      +      "average"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / provenance / properties / signedObservations / maximum
      Added value: +9007199254740991
    • removedOutput schema / properties / provenance / properties / totalObservations / $ref
      Removed value: -"#/properties/provenance/properties/signedObservations"
    • addedOutput schema / properties / provenance / properties / totalObservations / maximum
      Added value: +9007199254740991
    • addedOutput schema / properties / provenance / properties / totalObservations / minimum
      Added value: +0
    • addedOutput schema / properties / provenance / properties / totalObservations / type
      Added value: +"integer"
    • addedOutput schema / properties / requestId / pattern
      Added value: +"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • removedOutput schema / properties / to / $ref
      Removed value: -"#/properties/from"
    • addedOutput schema / properties / to / maxLength
      Added value: +40
    • addedOutput schema / properties / to / type
      Added value: +"string"
    • removedOutput schema / properties / verifiedArchiveSince / $ref
      Removed value: -"#/properties/from"
    • addedOutput schema / properties / verifiedArchiveSince / maxLength
      Added value: +40
    • addedOutput schema / properties / verifiedArchiveSince / type
      Added value: +"string"
    • removedOutput schema / properties / verifiedObservations / items / properties / assetId / $ref
      Removed value: -"#/properties/asset/anyOf/0/properties/assetId"
    • addedOutput schema / properties / verifiedObservations / items / properties / assetId / maxLength
      Added value: +600
    • addedOutput schema / properties / verifiedObservations / items / properties / assetId / pattern
      Added value: +"^(?:native:[a-z0-9][a-z0-9._-]{0,63}:[a-z0-9][a-z0-9._-]{0,255}|contract:[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}:[A-Za-z0-9._~:/+=@-]{1,512})$"
    • addedOutput schema / properties / verifiedObservations / items / properties / assetId / type
      Added value: +"string"
    • removedOutput schema / properties / verifiedObservations / items / properties / at / $ref
      Removed value: -"#/properties/from"
    • addedOutput schema / properties / verifiedObservations / items / properties / at / maxLength
      Added value: +40
    • addedOutput schema / properties / verifiedObservations / items / properties / at / type
      Added value: +"string"
  2. Addedv1.3.6

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/idempotent/non-destructive annotations, it discloses that candles and metrics are unsigned while only verifiedObservations rows carry signatures, that verification authenticates price fields only (no v2 block), that null signature or grade rows cannot be verified, and that the account plan clamps history with rangeClamped/from. It also states the auth requirement (PULSE_API_KEY or hosted server), which annotations do not cover.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with the endpoint and payload, and nearly every sentence carries a distinct fact (limits, clamping, verification caveats, auth). It is one dense paragraph of roughly 200 words, so it is efficient but harder to scan than a short bulleted structure would be.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 8-parameter paginated read tool with an output schema and rich annotations, the description covers the remaining unknowns: dataset semantics, row verification path, cap reasoning, clamping behavior, cursor handoff, and authentication. Nothing material an agent needs to call it correctly is left out.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, but the description adds real meaning: the 30-day default window before `to`, the 250-row cap for verified at 1h/1d and its cause (up to four signed prints per hour), and the exact assetId notation to use. The limit/pagination interaction is explained in a way the schema cannot express, though a few facts are restated from the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource ("Read one page of index history for a crypto symbol from /api/index/v1/history") and then enumerates exactly what a page contains: candles, summary metrics, pagination, and verifiedObservations. An agent can distinguish this from sibling read tools like get_index_price or get_index_batch purely from the stated scope and page semantics.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit conditional guidance: dataset=verified vs reconstructed, when to pass assetId ("when a symbol identifies more than one asset"), how to page ("pass pagination.nextCursor as cursor with the same symbol, dataset and interval"), and routes row verification to verify_print. What it lacks is any framing against the other sibling read endpoints (get_index_price, get_index_batch, get_recorded_print), so the agent must infer when this tool is preferable to those.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.