NAV Query API

Overview

The Harcourt NAV Query API gives AI agents and developers programmatic access to institutional-grade mining valuations without re-running full DCF models. Each covered company has a precomputed sensitivity matrix — a grid of NAV per share values across combinations of commodity price and discount rate — stored in Cloudflare R2. When you call the API, the Worker reads the nearest grid points and performs bilinear interpolation to return the value at your exact inputs.

Two access modes:

• Direct HTTP — free, no authentication. Use for prototyping, one-off queries, or low-volume access.
• Qatom MCP — $1 USD TDN per call. Use for production agent workflows that need autonomous, paid access with Qatom-settled billing. Discovered via the Qatom MCP marketplace; no hardcoding required.

Quick Start

1. Get Ivanhoe Mines NAV at copper $6.50/lb, 8% discount rate

curlcurl "https://reports.harcourtvaluations.ai/nav-query/ivn?cu=6.5&rate=0.08"

response{
  "ticker":        "IVN",
  "model_date":    "2026-06-29",
  "model_version": "v7",
  "inputs": {
    "cu":             6.5,
    "discount_rate": 0.08
  },
  "nav_per_share": 12.05,
  "currency":      "CAD",
  "disclaimer":    "For informational purposes only. Not investment advice."
}

2. Get Aris Mining NAV at gold $4,100/oz

curlcurl "https://reports.harcourtvaluations.ai/nav-query/aris?gold=4100&rate=0.08"

response{
  "ticker":        "ARIS",
  "nav_per_share": 59.65,
  "currency":      "USD",
  "model_date":    "2026-06-29"
}

Base URL

https://reports.harcourtvaluations.ai

All endpoints are served from this Cloudflare Worker. No versioning prefix is used; breaking changes will be announced at harcourtvaluations.ai.

GET /nav-query/{ticker}

Returns modelled NAV per share for the specified company at your inputs. No payment required for direct HTTP access.

Parameters

Path parameter

Query parameters

* Provide the commodity parameter that matches the ticker (see Covered Tickers below).

Response Format

JSON{
  "ticker":        "IVN",         // Uppercase ticker symbol
  "model_date":    "2026-06-29",  // Date model was published
  "model_version": "v7",          // Internal model version
  "inputs": {
    "cu":             6.5,          // Your commodity input, echoed back
    "discount_rate": 0.08          // Your discount rate, echoed back
  },
  "nav_per_share": 12.05,         // NAV per diluted share
  "currency":      "CAD",         // Denomination of nav_per_share
  "disclaimer":    "..."          // Standard disclaimer string
}

Response fields

Interpolation

Each company's JSON file in R2 contains a precomputed sensitivity_matrix — a grid of NAV per share values computed at discrete commodity prices and discount rates by running the full DCF model at each grid point. When you call the API, the Worker:

1. Loads {ticker}.json from R2 (cached)
2. Finds the four nearest grid points surrounding your inputs
3. Performs bilinear interpolation to compute NAV at your exact (commodity, rate) pair
4. Returns the result with the currency field from the matrix

Grid boundaries

If your input is outside the grid range, the Worker clamps to the nearest edge value rather than extrapolating. For IVN, the copper price grid covers approximately $4–8/lb. Inputs significantly outside this range will return the edge grid value, not an extrapolation. Check the sensitivity table in the PDF report to see the exact grid extents for each company.

Error Codes

Covered Tickers

Live Catalog

Returns the full catalog of available reports as JSON. Includes all metadata needed to build a UI or drive agent decisions about which report to purchase.

response{
  "reports": [
    {
      "id":           "ivn-nav-2026",
      "name":         "Ivanhoe Mines NAV Report",
      "ticker":       "TSX: IVN · OTCQX: IVPAF",
      "commodity":    "Copper · Gold · PGM",
      "flag":         "🇨🇦",
      "nav":          "C$12.05 / share",
      "p_nav":        "0.87×",
      "qatom_hash":   "d15e9e6e-...",   // Qatom commodity hash for payment
      "assets":        "Kamoa-Kakula · Platreef · Kipushi",
      "free_teaser":  "Three world-class assets..."
    }
    // ... more reports
  ]
}

Qatom MCP — Agent Access

For production autonomous agent workflows, use the Qatom MCP marketplace. The agent discovers and calls the tool without hardcoding URLs, and payment is settled automatically from the agent's Qatom wallet at $1 USD TDN per call.

Input schema (Qatom MCP)

JSON{
  "ticker":          "ivn",    // lowercase
  "commodity_param": "cu",    // "cu" | "gold" | "u3o8"
  "commodity_price": 6.5,    // numeric value in appropriate unit
  "discount_rate":   0.08   // decimal
}

The response shape is identical to the direct HTTP endpoint.

Claude / Claude.ai usage

If you are using Claude with the TODAQ MCP server connected, you can call the tool directly in a Claude session:

MCP tool call// In a Claude session with mcp.m.todaq.net connected:
test_tool({
  tool_id: 77,
  args: {
    ticker:          "aris",
    commodity_param: "gold",
    commodity_price: 4100,
    discount_rate:   0.08
  }
})

PDF Report Tools (Qatom MCP)

Each covered company has its own Qatom MCP tool for purchasing the full PDF report. These tools charge $15 TDN and return a download URL for the PDF.

Agent Wallet Setup

To call Qatom-gated tools autonomously (no human approval per transaction), an agent requires a funded Qatom sandbox wallet.

Setup steps

1. Create a primary wallet at todaq.net. This is human-controlled and MFA-gated.
2. Fund the primary wallet with USD TDN via the chargeup URL (load.m.todaq.net).
3. Transfer to agent sandbox using the transfer_to_agent_wallet tool or the TODAQ Console. The sandbox wallet requires no MFA and is the one actually debited by tool calls.
4. Confirm balance is sufficient. $1 per NAV query, $15 per PDF report. Set a minimum balance threshold appropriate for your workflow.

Chat API — Klondike Mike (Free)

Free conversational access to Harcourt's data. Powered by Claude Haiku. Returns plain-language NAV analysis, P/NAV commentary, and key catalysts. No authentication or payment required.

request{
  "messages": [
    { "role": "user", "content": "What's Ivanhoe's P/NAV at copper $7/lb?" }
  ]
}
// Content-Type: application/json

response{
  "content": [
    {
      "type": "text",
      "text": "At copper $7/lb and an 8% discount rate, IVN's modelled NAV is approximately C$14.44/share. With the stock trading around C$10.50, that's a P/NAV of roughly 0.73× — a meaningful discount to NAV. Kamoa-Kakula's smelter is now producing sulphuric acid credits (~$1M/day), which isn't fully reflected in the market yet, partner. Want the full model for $15?"
    }
  ]
}

The chat agent's system prompt is generated server-side from live {ticker}.json data in R2, so it always reflects the most recently published NAV. Include conversation history in the messages array for multi-turn sessions (max 10 turns retained server-side).

Free Sample Report

Returns a full institutional NAV report PDF as a file download. No payment or authentication required. Use this to inspect the exact format and contents of a Harcourt report before calling the paid PDF tools.