Public pages, learning and the API

This chapter covers everything you can open without an account, and the ways to bring Kresmion data into your own tools. It has three parts: the public site itself (the header, footer, search, languages and the sign-up card a visitor sees), the pages about Kresmion and for reading (landing page, About, Methodology, Pricing, Support, Newsroom, the Learn library, this User Guide and the legal pages), and the developer surfaces (the REST API, API keys and limits, webhooks, the MCP server for AI assistants, the local stdio server, the Python SDK, the Excel add-in and the field registry).

The pages you will use most, and the question each answers:

• Landing page (/): what is Kresmion and what does the workspace look like?
• Methodology (/about/methodology): how is this number computed, how often does it update, and where does it come from?
• Learn library (/learn, Cmd-K LEARN): is there a plain-language explainer or study on this concept?
• Developer page (/developers, Cmd-K DAPI): how do I connect an assistant, call the API, and what are the limits?
• Field registry (/developers/fields): which field, series or Excel function carries the number I want, and where is it from?
• User Guide (/guide, Cmd-K GUIDE): where is a page and how do I read it (this guide, on the web and as a PDF)?

A few rules hold across the chapter:

• Public means no account. Every page here opens signed out. The developer page is public, but creating a key, a webhook or an assistant connection needs a free account.
• Kresmion is free during beta. Billing is not switched on and no card is needed. The Pricing page shows the plans Kresmion moves to when billing opens; nothing on the site takes a payment today.
• Information only. Public pages frame events with the source and date on the numbers that carry them, and none gives buy or sell advice.
• The public research pages live in other chapters. Company research, research notes, the daily brief, the event archive, prediction markets, the Smart Money Feed and the public tools are documented where their subject is: see Other public pages.

The public site frame

Every public page shares one header and one footer (the landing page has its own footer, described with it). A few pages that sit outside the main public area (the legal pages and Methodology) carry the same header and footer but no search button and no sign-up card.

Public header

Getting from any public page to any other public page, to search, to your language, and into the app.

• Wordmark ("kresmion." with the orange mark) on the left. It always returns to the landing page of your language.
• Three menus on a desktop, each opening a panel of links with a one line description (descriptions show in English only):
  • Platform: Workspace ("Explore the connected terminal"), Tools ("Browse the public research tools"), Guide ("Get started with Kresmion"), Developers ("API, SDK and integrations"), Kresmion ("About the platform and research").
  • Explore: Feed ("Follow events across markets"), Odds ("Explore prediction markets"), Midterms 2026 ("Senate and House control odds", English only and temporary until those markets settle), News ("Read the latest market coverage").
  • Research: Research Notes ("Long-form, source-cited analysis"), Daily Brief ("The automated daily market summary"), Research ("Explore company research"), Learn ("Understand the tools and concepts").
• Two direct links after the menus: Methodology and Pricing.
• On the right: Search with its shortcut (⌘K on a Mac, Ctrl K elsewhere), the language pill (for example "EN ▾"), Sign in, and the orange Get started button.
• Signed in, Sign in disappears, the orange button reads Go to dashboard, and a profile chip (your avatar or initial and your name) opens a small menu: your name and @username, Go to dashboard, Settings, Sign out.
• On a phone or narrow window (up to 1200 px wide) the menus fold into a menu button (three lines; it becomes an X when open). The sheet lists the same three groups plus a Kresmion group (Methodology, Pricing), a Language row with the switcher, then Get started (or Go to dashboard) and Sign in (or Settings and Sign out).

• Click a menu name to open it; click it again, click elsewhere, or press Esc to close. With the keyboard, ↓ on a menu name opens it and focuses its first link, ↑ its last; inside a panel ↑ ↓, Home and End move between links.
• The search button appears only where search works; on pages without it, ⌘K does nothing.
• The menu closes itself when you follow a link or resize across the phone breakpoint.

On a translated page the links to pages that have a translation (Research Notes, Daily Brief, Learn, About, Methodology) keep your language; the rest open in English.

Public footer

A full site map in four columns, the follow links, and the language switcher.

• Brand column: the Kresmion logo, the one line description of what Kresmion is, and Follow: @Kresmion on X and Telegram.
• Read: News, Research Notes, Daily Brief, Methodology, Insights, Learn, Guide, About.
• Research: NVDA, AAPL (two example company research pages), Event archive, Prediction markets, Free tools, Developers, Pricing.
• Platform: Sign up, Sign in, Privacy, Terms, Accessibility, Support.
• Bottom line: "© <year> Kresmion. Data shown is informational, not investment advice." and a second language switcher.
• Language suggestion banner. If your browser's language is one Kresmion is translated into and differs from the page, a small banner at the bottom offers the switch in that language ("View Kresmion in ...", Switch or No thanks). It appears once: choosing either answer, or having picked a language before, stops it.

Search on the public site

Jumping to a ticker, a page, a dataset or a function code from the public site, with the same command bar the signed-in app uses.

It is the same command bar described in Command bar (Cmd-K): type a ticker, a company, a topic, a page name or a function code. On the public site a result that needs an account carries a small lock ("Needs a free account").

Search is available on the English public pages. The translated pages, the legal pages and the Methodology page have no search button, and ⌘K does nothing there.

Languages and translated pages

Reading the public site in English, Korean (한국어), Turkish (Türkçe), Chinese (中文), Spanish (Español), French (Français) or Arabic (العربية).

• The pill shows the current language code ("EN", "FR" ...). The list shows each language in its own script with a check on the current one.
• English lives at the plain address (/learn); each other language adds its code in front (/fr/learn, /ko/learn). Arabic pages read right to left.
• Which pages are translated:

• Everything else is English only: Pricing, Developers, the field registry, the User Guide, Tools, Support, Newsroom, API terms, company research, odds, the feed, the sign-in and sign-up pages and the whole signed-in app. Links to them from a translated page open the English page.
• On a translated Learn article, a note at the end says translations are machine-generated and the English original is authoritative, with Read the English original.

Pick a language: you go to that language's landing page, and the choice is remembered for a year in this browser. While you are signed out, opening / afterwards takes you straight to your language's landing page. Choose English to go back.

/en is not an address: it returns to /. A translated Learn article that does not exist yet shows "not found"; the translated Learn library links such articles to the English page instead.

Sign-up card and email capture

The card: leaving an email to receive the next research note, then optionally opening a free account. The phone bar: opening a free account from the tool you are reading, and coming back to it.

• Step 1, the email card. On a wider screen the card opens with a picture of the public futures curve tool (hidden on a phone). Then "FREE, NO ACCOUNT", one line on what Kresmion does ("We read the filings, the disclosures and the wallets in full, with the source and date on the numbers that carry them."), a headline, a line of support text, an email field, Send me the next finding, and the fine print: no fixed schedule, it goes out when the data has something in it, unsubscribe at any time, and the data is never sold. The headline changes with the page you are on, for example "Every market we follow, tracked to settlement." on the odds pages or "Put the method to work on live filings." on Learn. If you are reading a second brief in one sitting it reads "Second brief in one sitting. Get tomorrow's in your inbox."
• Step 2, after you subscribe. "You're on the brief. Now open the terminal.", then "You are on the list. The next note goes out when there is one." and what a free account opens: the signed-in view of every tool, a start page that searches every section, and My dashboard, built from the markets you trade. Then Open my free terminal, Continue with Google and Maybe later.
• The phone bar (tools and markets pages, on a phone). One line, "Open every tool's signed-in view, free.", a Google button, an Email button and a close button (×). It asks for an account, not an email address, and it never covers more than a thin strip at the bottom of the screen.
• The in-page card (under a Learn article and a day's Daily Brief, and on the odds pages). "FREE, NO ACCOUNT", a heading ("Put this to work" on Learn, "Get the smart money brief" on a brief), Get the morning brief by email with an email field and Email me the brief, and Or get live alerts on Telegram with Join on Telegram ("One tap. Live alerts, no email needed."). After you subscribe it reads "You are on the list."
• The company research page has its own capture block, described in Company research page.

• Type your email and submit. An invalid address shows "Please enter a valid email."; a server problem "Something went wrong. Please try again."
• No thanks, just browsing or the close button dismisses the card; the bar's × dismisses the bar the same way.
• How often it appears: at most once per browser tab session and once a day; after you dismiss it, not for three days; after you subscribe, never again in this browser. The card and the phone bar share these limits: whichever one you saw counts. Neither appears on the landing page (English or translated), on embedded cards, on the app-approval page or on a shared portfolio link, nor in a tab where you have just used the signed-in app.
• One ask at a time. While a page shows its own account prompt (the card on a locked tab of Greeks exposure), the phone bar waits; it can appear once that prompt is gone, for example after you switch to the GEX tab.

Subscribing is enough to receive the research note by email; an account is a separate, optional step.

Landing and company pages

Landing page

A first look at what Kresmion covers, a sample of the workspace, the principles behind the data, and the latest notes and explainers.

From top to bottom:

• Hero. "Macro, equities and crypto intelligence on one screen" over "A world of data. A clearer view.", then "Understand what's moving markets." and one sentence on what Kresmion is. Two buttons, Start exploring free and Explore the platform, and two ticks: "Free during beta" and "No credit card". On the right an animated globe of points with three labels (Macro and positioning, Filings and institutions, On-chain and flows). A Scroll to explore cue at the bottom.
• Coverage strip. "ONE WORKSPACE. EVERY ANGLE." with six areas: Macro, Equities, Crypto, Institutional flows, On-chain activity, Global events.
• The connected workspace ("The whole picture. Finally, in one place."). A note reads "Illustrative Home screen · Sample data" before the picture: everything in it is a sample with made-up figures, not live data. The sample has the real app's menu bar (open a menu to see the real menu items, which are labels here, not links), a strip marked SAMPLE, and nine sample panels: US indices, Performance (four indices rebased to 100), S&P sectors, Fresh filings, FX commodities and crypto, Rates, Week ahead, Daily brief and Intelligence feed. On a phone, swipe sideways across the board. Under it: "Trace events to their original source.", "Choose the panels on your Home." and Make it yours.
• Follow the connections ("Markets don't move in isolation."). Four numbered stages: Start with the world, Follow the capital, Look inside the institution, Put it in perspective. Click a stage to read it; the picture beside it changes and names the sources behind that stage.
• Built around your process. Three cards: "Your Home. Your panels.", "Follow what matters to you." and "Take the data further." (REST API, Python SDK, Excel add-in and MCP server).
• The Kresmion standard ("Conviction starts with the evidence."). Three principles: go straight to the source (with the source names SEC EDGAR, FRED, CFTC, Ethereum, Bitcoin, IMF PortWatch), your judgment stays yours, your positions stay private (your portfolio is encrypted in your browser).
• From the research desk. The three latest research notes, each with its date and title. Hidden when none is available.
• Learn. A few curated explainers, each with a topic label (Options, Futures, Filings, Macro, Trading basics). Hidden when none is available.
• Good questions. Clear answers. Ten questions you can open one at a time: what Kresmion is, the getting started guide, portfolio encryption, whether messages are readable, what linked events are, buy and sell recommendations (there are none), how current the data is, the API, pricing, and what happens when you delete your account.
• Closing. "Make sense of what moves markets." with Start exploring free.
• Landing footer. The wordmark and "Independent intelligence. A connected view of the markets."; Platform (Public tools, Pricing, Developers), Explore (Research notes, Learn, Research, Getting started, Methodology), Connect (X / Twitter, Telegram, Create an account); then "© <year> Kresmion SASU", "Market intelligence for your own research. Not investment advice." and Privacy, Terms, Accessibility.

Open and close the sample menus with a click or Esc; arrow keys move between them. Click a story stage to switch it. Click a question to expand its answer. Nothing on the sample board opens a real page.

The header shows Go to dashboard and your profile chip instead of Sign in and Get started; the sign-up card never appears here. The page's own buttons still point at sign-up, so use Go to dashboard to reach Home.

If you chose another language with the switcher, opening / signed out takes you to that language's landing page. On a translated landing page the notes and Learn links stay in your language when a translation exists.

About

A short statement of what Kresmion is, what it covers, how it is priced during the beta, and who publishes its research.

• What Kresmion is. A source-first market terminal for cross-asset market intelligence, for individual investors and small funds: equities and SEC filings, macro and rates, crypto and on-chain flows, and prediction markets in one workspace; where a number comes from a filing, a report or a release, it links to that source. It is information-only: no buy or sell recommendations, price targets or predictions.
• Pricing. Free during beta, an account takes about 30 seconds with email or Google, no card; paid tiers are planned and beta accounts are told before anything changes.
• What Kresmion does well. One live terminal for the cross-asset picture an individual investor monitors, free during beta; filings read alongside the macro regime, on-chain tracking and prediction-market consensus; the positioning and event record behind price, with the source and date on the numbers that carry them. It names no other product.
• What is published openly. The dated research notes, the Learn explainers and the per-ticker research pages, all source-cited and written by Kresmion Research.
• Kresmion Research (#research-desk). The publishing name used for the notes and explainers; part of Kresmion, not an independent ratings agency, and the byline does not imply an outside expert reviewed an article.
• Editorial approach and corrections (#editorial-policy). How notes are reviewed, and what to include when you ask for a correction: the page address, the statement, and the primary source that supports the correction.

The translated About pages carry a translated version of this text.

Every Learn article and research note links its byline to /about#research-desk and its editorial line to /about#editorial-policy.

Methodology

The reference for how every surface works: what each page is for, how its numbers are computed at a conceptual level, how often each source updates, and where the data comes from. When a page in the app has a Methodology or About this data link, it opens a section here.

• Eyebrow "Platform & Methodology", title "How Kresmion works", and an introduction: Kresmion is a terminal that reports what happened, with sources and dates, and makes no recommendation.
• On this page: a contents list. Plain capitals are desk headings (Macro desk, Equities desk, Futures and commodities desk, Crypto desk, Intelligence desk, Events desk, Portfolio and workspace); the orange numbered entries are the sections under them.
• Thirty numbered sections, among them: 1 Platform overview (#platform), 2 Keyboard shortcuts (#keyboard), 3 Update frequencies (#update-frequencies), 4 Macro regime engine (#macro-regime), 5 Central banks and policy rates, 8 Yield curves, 12 Treasury TIC foreign holders (#treasury-tic), 13 Company fundamentals and relative value, 14 13F institutional tracking (#13f), 15 Insider Form 4 clusters (#insider-clusters), 16 Congressional trading, 17 Activist investors (#activist-investors), 18 Bond issuance (#bond-issuance), 20 Futures and commodities analytics (#futures-analytics), 21 Crypto ETF flows, 22 OSINT pipelines, 23 Linked events, 24 Prediction markets (#prediction-markets), 25 Event hygiene and track record, 26 Portfolio and on-chain wallets, 29 Reading public research data, and 30 Data sources (#data-sources).
• Last updated with a date at the bottom.

Click an entry in the contents to jump to it; every section has a stable address (/about/methodology#<section>) you can bookmark or share.

Start with section 3 (Update frequencies) when you want to know how fresh a number should be, and section 30 (Data sources) for who publishes each input. This page has no search button and no sign-up card.

Pricing

Seeing which plans Kresmion moves to once billing opens, and the conditions that will apply. Today every account is free.

• "Simple pricing." with a Start free button, and an orange note: billing is not switched on yet; while Kresmion is in beta every account is free and needs no card; these are the plans it moves to, and you are told before anything changes.
• Three plan cards: Basic (marked "Default plan"), Developer and Business. Each shows its planned monthly price excluding VAT, the VAT-inclusive figure and a yearly option (Business reads "Custom"), a one line description, and a list of what it includes. These figures are the planned prices for when billing opens; nothing is charged during the beta.
• Tax line: headline prices exclude VAT; the tax-inclusive total is on each plan and again at checkout.
• API and MCP server line: the API and MCP server come with Developer, with its limits; Basic does not include them. Then "During the free beta, every account gets 10,000 API calls a month." and a Details link (see Rate limits and key rules).
• Before you subscribe: the seller's company details, automatic renewal with an email before each renewal and online cancellation, the 14-day withdrawal right for distance contracts, the half-price offer for accounts created before the stated cut-off date, and the consumer mediator for disputes.
• A closing line: Kresmion reports what happened with sources attached; it is not investment advice.

Your own account's plan is shown in Billing once you are signed in.

Support

How to get help, and the right place for each kind of question.

• How to get help. Email inquiry@kresmion.com: the person who builds Kresmion reads and answers every message. Say which page you were on and what you expected to see, with a screenshot if you can.
• Your account. Reset a forgotten password; delete your account and its data; billing (free while in beta, nothing is charged; your plan lives in Settings, Billing).
• A number looks wrong. Email with the page address, the number and what you expected (the link opens an email with the subject "Data question"). Figures are checked against the source filing or release and the data itself is fixed.
• API, MCP server and Excel. Setup and limits on the developer page; create or revoke keys; disconnect Claude, ChatGPT or another app; for an error, include the request path, the time in UTC and the error code.
• Security. Report an issue by email (subject "Security") with steps to reproduce; do not test against other people's accounts.
• Legal. Privacy policy · Terms of use · API terms.

The settings links need you to be signed in; signed out, you are asked to sign in first and then return to the page.

Reading on the public site

Newsroom

One list of official headlines from central banks, regulators and government sources, newest first, filterable by source and topic.

• Eyebrow "Financial news", title "The newsroom", and a line naming the sources (the Federal Reserve, ECB, Bank of Japan, Bank of England, SEC EDGAR, the White House and the DOJ). "Public RSS feeds · refreshed every 30 minutes."
• Each headline: the source in orange capitals, the publication time in UTC, a topic chip when the item has one, the headline itself, and, on some items, a short neutral context note marked Automated note (hover: written automatically by software from the headline, not by an editor). The line under the title says the same. Context notes describe; they carry no recommendation.
• With a filter on, a line counts the matching items ("N items from <source> · <topic> · clear filters").
• Pages: 30 headlines per page, "Page n of m" with ← Newer and Older →.
• Empty states: "No news items match this filter. Try clearing it." or "No news items available right now. Check back shortly."

• Filter news: a Source row and a Topic row of pills, each starting with All. Picking a pill reloads the list; source and topic combine. On a phone the pills fold behind a Filter button that shows how many filters are on.
• Click a topic chip on any headline to filter by that topic.
• Filters and the page number live in the address (/newsroom?source=...&category=...&page=...), so a filtered view can be bookmarked.

The signed-in news pages (crypto news, the intelligence feed) are different pages; see Intelligence.

Learn library

Finding a plain-language piece from Kresmion Research: an explainer that teaches a concept (gamma, a 13F filing, the yield curve, a funding rate) or a study that runs the numbers on Kresmion's own data. Every piece cites the data it is built on.

• Title "Research papers & explainers" and a line saying each piece is information only.
• Search box ("Search papers: gamma, 13F, rates"), with a / hint.
• Type switch: All, Explainers, Studies, each with its count.
• Topic chips: All topics plus seven shelves, each with its own colour swatch and a count of the pieces it would show: Prediction markets, Crypto, Options & greeks, Stocks & filings, Futures & positioning, Macro & rates, Basics & methods. A chip with nothing to show is greyed out.
• A status line: "N papers, newest first within each topic", or while filtering "N papers matching "<words>" in <topic>" with Clear filters.
• Cards: the topic (with its colour), "Explainer" or "Study", the title and the publication date. With no filter the cards are grouped on shelves by topic, each shelf headed with its count; while filtering they form one grid ranked by how well the title matches.
• Empty: "No paper matches that yet. Try a broader word, or show every paper."

• Type to filter as you go: every word must appear (title matches rank first). Press / anywhere to jump to the box, Esc to clear it, or the × button.
• Click a type or topic to narrow; click the same topic again to remove it. Your search, topic and type are kept in the address (?q=&topic=&type=), so a filtered view can be shared.
• On a phone the topic chips fold behind a Topic button.

/<language>/learn lists studies and explainers in two plain lists with translated headings. A piece with a translation is listed first, under its translated title, and opens the translated article; the others open the English article. The note under the heading says so: most articles are published in English, and a translation, where one exists, is listed first.

Learn article

Reading one explainer or study, with its sources, and jumping to the live page where the concept can be seen in today's data.

From top to bottom:

• ← All research papers, then "Explainer · Kresmion Research" (or "Study · ..."), the title, the date and an estimated reading time.
• Byline: "Published by Kresmion Research. Read our editorial approach and data methodology."
• Share buttons: X, LinkedIn, Reddit.
• Theme and ticker chips. A theme or ticker that has research notes is a link; one with none is plain grey text.
• Current reading (on some explainers): today's dated value of what the article explains, for example the current yield curve or VIX reading. "Updated from the latest stored data each hour. The explainer below is dated at its publication."
• See it live (a small line near the top on most articles): the live Kresmion page for this concept.
• The article, then a related reading box that lists other pages on the same subject, with "Primary-source background" links and a link to the methodology.
• Sources: each source the article cites; a source with an address is a link.
• The live panel: on options and greeks articles, a live exposure chart for SPY (delta, vega, theta, charm and the like) dated by its last capture; on other articles a See it live card naming the live page and what you will find there.
• The in-page email card (Sign-up card) and a closing line: information, not investment advice, with links to the methodology and the latest research notes.

Translated article (/<language>/learn/<article>): the same article in that language, with ← back to the translated library, and at the end a note that translations are machine-generated and the English original is authoritative, with Read the English original. An address with no translation shows "not found".

A wrong or retired address shows "Paper not found" with a link back to Learn.

User Guide

This guide: where every page lives, how to read each panel and number, and where each click takes you. The same text is available as a PDF.

• Eyebrow "USER GUIDE", the guide's title and subtitle, Start reading, Download the PDF, and the guide's version date.
• Chapter cards, numbered 01 to 11: the chapter title, a one line summary, and up to eight of its main sections as links.

The guide is English only. In the PDF, links to product pages become full https://kresmion.com/... addresses.

User Guide chapter

• "USER GUIDE · CHAPTER NN", the chapter title and its summary.
• In this chapter (left column on a desktop, kept in view as you scroll): every section and page of the chapter, with page sections indented, and Download PDF under it. On a phone it is a fold-out In this chapter list above the text, with the main sections only.
• The chapter text. In the Getting around chapter, the function code tables are generated from the command bar itself, so they always match it.
• Previous and Next at the end, naming the neighbouring chapters; the last chapter offers Back to All chapters.

Every heading has its own address (/guide/<chapter>#<section>), so you can link straight to a page's section. Links inside the text jump to other chapters or open the product page they name.

Legal pages

The legal pages describe the rules that apply to you and to Kresmion. This guide only says what each page covers; the page itself is the text that applies. Each has the public header and footer, no search button and no sign-up card, and a date at the top showing when it was last updated.

Terms of Service

Sixteen numbered sections: what Kresmion is and is not, eligibility, your account, acceptable use, community content and messages, API access, third-party data, intellectual property, availability and changes to the service, disclaimer of warranties, limitation of liability, termination, changes to the terms, governing law and disputes, general provisions, and the contact and company information.

Privacy

Headed "Privacy commitment" over "Your portfolio. Encrypted in your browser. Period.", then: who we are, what we collect, what we do not do, why we process data (the legal bases), cookies and local storage, who receives data (subprocessors), how long data is kept, account deletion, your rights, security, data breaches, children, and changes to the policy. It is also where the contact details for data questions are.

Accessibility

"Accessibility at Kresmion": the conformance status, what we do, the known limitations, and how to report a barrier.

API terms

"API terms of use": the terms for the REST API, the MCP server, bulk export and the SDK, on top of the Terms of Service. Twelve numbered clauses: what the terms cover, the licence, what you may not do, upstream restrictions that pass through to you (with the exact credit line some sources require), attribution, rate limits and fair use, keys are read only, no warranty on the data, not investment advice, suspension, changes, and the law and how to raise a dispute. The company details close the page.

The contact address opens a new email to inquiry@kresmion.com; the mediator link opens its dispute form in a new tab.

Other public pages

Many public pages are documented in the chapter for their subject. Signed in, several of them open the full app page at the same address instead.

• Company research: /research (Company research directory), /research/<TICKER> (Company research page), /research/no-longer-listed (Companies no longer listed).
• Research notes: /notes (Research notes), /notes/<date> (Research note), by theme (Notes by theme) and by ticker (Notes by ticker).
• Daily Brief: /daily-brief (Daily Brief), /daily-brief/<date> (A day's Daily Brief); the older archive at /insights (Daily briefs archive).
• Events: /signals/archive (Event archive).
• Macro: /macro/regime (Macro regime).
• Prediction markets: /odds (Prediction market odds index) and /odds/midterms-2026 (2026 midterms board).
• The Smart Money Feed: /feed (Smart Money Feed).
• The public tools: /tools and every /tools/<tool> page (Tools hub).
• A shared portfolio link: /share/<token> (Shared portfolio composition).
• Approving an app's access (opened by an assistant connector): /oauth/consent (Approve an app's access).

Developers

Kresmion data is available outside the website in five ways: the REST API (any HTTP client), the MCP server (AI assistants such as Claude and ChatGPT), the local stdio server (an MCP server you run yourself), the Python SDK, and the Excel add-in. Webhooks push events to your own server. All of them read data only, run on a key from your free account, and share one monthly quota. The Developer page is the reference; the sections below follow it.

You manage your access in Settings: API keys (keys, usage, IP allowlists), Webhooks and Connected apps (assistants you approved).

Developer page

Everything needed to use Kresmion data from code or an AI assistant: how to connect, a quickstart, the product areas, the live endpoint reference, errors, limits, attribution duties, webhooks, MCP, the SDK and Excel.

• Header. "Developers / API", "The Kresmion API", and what it covers: SEC filings and reported financials, insider and congressional disclosures, macro, on-chain crypto flows and Polymarket prediction markets, with the source and date on the records that carry them. Information-only, not investment advice.
• Four buttons: Connect Claude or ChatGPT, Get an API key, Read the reference, Browse every field.
• Section chips: Connect an assistant, Quickstart, Products, Reference, Limits and tiers, Attribution, Webhooks, MCP, Python SDK, Excel.
• Three facts: Base URL https://kresmion.com/api/v1, Auth Authorization: Bearer krm_..., Spec openapi.json.
• Then the sections, each described below: Connect, Quickstart, products and reference, Errors and attribution, Rate limits, Webhooks, MCP (with the local stdio server), Python SDK and Excel.
• Closing note: the API is free during beta; there is no uptime SLA yet; figures can lag their upstream sources or be revised; read the methodology and data caveats before you build on a number.

Every code sample has a Copy button (it reads "Copied" for a moment). Each section has its own address (/developers#connect, #quickstart, #products, #reference, #errors, #limits, #attribution, #webhooks, #mcp, #sdk, #excel).

Connect Claude or ChatGPT

The fastest way in, with no key to copy: your assistant signs in with your Kresmion account and gets read-only access to the data.

1. In Claude: Settings › Connectors › Add custom connector. Paste https://kresmion.com/api/mcp and leave the OAuth fields empty.
2. In ChatGPT, where your plan offers custom connectors: add one with the same address and choose OAuth.
3. Sign in with Kresmion and approve read access on the approval page (Approve an app's access).

• Then ask: three example questions to try (Filings, Disclosures, Macro), each asking for dated, sourced facts, for example NVIDIA's revenue and net income in its last three quarterly filings, with a link to each filing.
• Answers come with the as_of time and the source on the records that carry them; filing answers carry the accession number and the sec.gov link.
• Three ready-made prompts the server offers: filing_brief (a dated brief of a company's recent SEC filings and reported figures), what_changed_since (what was recorded since a date: insider clusters, congressional disclosures and other changed rows) and macro_backdrop (the macro and rates backdrop, with dates and sources).

The connection uses your account's quota. It is listed in Connected apps (and its key also appears in your API keys list). The page says to revoke it from the API keys page; use Disconnect in Connected apps instead, which also cancels the app's stored sign-in so it cannot reconnect without your approval.

REST API: quickstart, products and reference

Making your first call, seeing what each product area offers, and looking up any endpoint.

• Quickstart. Mint a key at /settings/api-keys, then list a company's latest SEC filings and its reported revenue, each value with the filing it comes from. Three tabs: curl, Python (plain HTTP) and Python SDK. The examples use NVDA: the five latest 10-Q and 10-K filings with accession and sec.gov link, and reported revenue for the last three quarters. Send the key as a Bearer token on every request.
• Products: six areas, each with a description and representative endpoints:
  • Prediction Markets (Polymarket): markets, probability history, order books, movers, calibration.
  • Crypto: labelled whale transfers, exchange holdings, ETF flows, derivatives, funding, liquidations. BTC and ETH ETF flows per trading session come back withheld (total_kind "withheld", withheld_reason "source_not_licensed"), because the only per-fund session flows held for them carry no redistribution licence; AUM and fund counts are served.
  • Equities: filing events, SEC Form 4 insider clusters, congressional trades, 13F positioning, FINRA short interest and daily short volume.
  • Macro and Rates: the regime score, central bank policy rates, US money markets and the Fed corridor, sovereign 10Y spreads (a Kresmion calculation, not a credit rating), World Bank and OECD statistics, the Fed path ladder, the Treasury curve history, curated FRED series, the surprise index, Fed liquidity, CFTC COT, Treasury TIC and BIS policy rates.
  • Companies: peer relative value from SEC fundamentals, a multi-filter screen, IPOs and equity offerings with prospectus terms.
  • Events and Intelligence: one scored event feed, the published track record (losses included), confluence composites, smart-money scores, a per-symbol brief, a change feed for polling, and a status endpoint.
• The response envelope, the same everywhere: data, count for lists, as_of for freshness, and meta for filters, sources, caveats and attribution.
• API reference: rendered live from the OpenAPI spec, every endpoint grouped by tag. Each row shows a coloured method chip (GET, POST), the path and a summary; expand it for Parameters (name, Required, Description) and Responses. While it loads: "Loading the live API reference..."; if it cannot load, a link to the raw spec.

Switch quickstart tabs; copy a sample. In the reference, type in Filter endpoints by path, tag, or summary to narrow the list ("No endpoints match that filter." when nothing does), and click a row to expand it.

Rate limits and key rules

• During the free beta every registered account can create its own key, and the API, the MCP server, the SDK and the Excel add-in all run on it at no charge.
• The table (Tier, Monthly calls, Rate limit, Over limit, Access):

• A request over the per-minute limit gets a 429 with a Retry-After header saying how long to wait. The monthly quota resets each calendar month and is shared by all your keys and connections.
• The note under the table: when billing opens, the API and MCP server come with the Developer plan (EUR 80 a month excluding VAT, 100,000 calls a month, 600 requests a minute); Basic does not include them. During the free beta, every account gets 10,000 API calls a month and 120 requests a minute, and nothing is charged. Need more today? Email inquiry@kresmion.com.
• Securing a key:
  • A key is for reading data. A request made with a key using a write method (POST, PUT, DELETE) is refused with a 403, except two POST routes that carry a query body and write nothing: the screen and the sheet evaluator.
  • Account data such as portfolios and messages needs a signed-in session, never a key.
  • You can lock a key to exact IPv4 or IPv6 addresses; from any other address it is rejected with a 401. Leave the list empty to accept any address.
  • A key is shown in full only once, at creation; you can revoke it at any time; you can hold up to five active keys.

Your live usage against these limits is on the API keys page.

Errors and attribution

• Errors. A 400, 404, 422 or 429 answers with {"detail": {"code", "message", "hint", "docs_url"}}. The code is stable, so your program can branch on it; the hint says what to change (for example which id forms a route accepts); a 422 adds the failing errors; a 429 adds retry_after in seconds. A 401 or 403 keeps a plain message. Over MCP every failure comes back as a tool error with the same fields.
• Not sure which id to send? GET /v1/search?q=NVIDIA resolves a company name, ticker, CIK, prediction market or FRED series to the id the other routes accept (the MCP tool is resolve).
• Attribution and caveats. Some data owners require a credit line wherever their data is shown. The response carries it in meta.attribution, and you must keep that text with the figures when you display, store or pass them on. Two families carry one today: Short volume ("Source: FINRA. Reg SHO Daily Short Sale Volume data owned by FINRA.") and Sovereign spreads (the ECB source line and notice, the statement that Kresmion computes the spreads from published yields, the OECD and Federal Reserve H.15 citations, and the FRED notice). meta.caveats lists a dataset's known limits (a lag, a single venue, a withheld value) and meta.source names the upstream.
• Citations per record. Company filings and financials carry accession_number, filing_date and sec_url on every row. Rows from disclosures (insider clusters, congressional trades, 13F holdings, and events with an originating filing) carry a citation object: source, url, accession, filed and observed_at. Quote the url next to the number.

The full licence conditions are in the API terms.

Webhooks

Receiving events at your own address instead of polling.

• Up to five webhooks per account, each optionally filtered to event types and symbols. Each delivery is signed with HMAC-SHA256 over the raw body, sent as X-Kresmion-Signature: sha256=<hex>.
• Events (Event, Fires when):

• Example payload: a whale.transfer event with fired_at and a data block (chain, labels, direction, USD amount, transaction hash and time).
• Verify the signature (Python): a short function that recomputes the HMAC with your webhook secret and compares it to the header; reject the payload when it does not match.

MCP server for AI agents

Letting an AI agent read Kresmion data over the Model Context Protocol.

• The hosted server exposes 47 tools; all 47 read data and none writes, pays or changes state. Every response carries the same envelope and freshness stamp as the HTTP API, and the same key, quota and rate limits apply. Start with kresmion_status to see how fresh each data family is.
• Tool families: Start here (kresmion_status, kresmion_brief, changes_since, field_search, resolve); SEC filings (3 tools); Prediction markets on Polymarket (8); Crypto (5); Equities and companies (10); Macro and rates (13); Supply chain (semiconductor_corridors); Event record (signal_track_record, confluence).
• How the OAuth connection works (Sign in with Kresmion): add a custom connector with the server address and empty OAuth fields; the client finds the Kresmion sign-in, opens the approval page, and after you approve receives a managed key with the kresmion:read scope, limited to the data API and sharing your account's quota.
• Bearer header (Claude Desktop, Claude Code and other clients): a configuration block for the hosted endpoint over streamable HTTP with your key in the Authorization header, and the one-line claude mcp add command for Claude Code.

Replace krm_your_key_here in the samples with your own key. To disconnect an OAuth client, use Connected apps; to stop a key-based client, revoke its key in API keys.

Local stdio server

Running the MCP server on your own machine. It carries the same 47 tools, generated from the hosted server, and calls the same HTTP API with your key from the environment (KRESMION_API_KEY).

Download the file, then register it with your MCP client over stdio. The page's sample runs it with uv (adding the mcp and httpx packages); without uv, install mcp and httpx with pip and run python kresmion_mcp.py.

Python SDK

Calling the API from Python with named methods instead of building requests by hand.

• The kresmion package wraps the /v1 API in namespaced methods (k.prediction, k.crypto, k.equities, k.macro and more) and waits as the Retry-After header asks. The page states the version of the single-file build it serves (currently 0.6.1, the same version PyPI installs), which needs Python 3.9 or newer and requests.
• Every result carries .as_of and .meta (caveats, source, and any attribution line you must reproduce). The example reads Italy's sovereign spread and prints its date and attribution.
• Version 0.4.0 removed six methods together with their routes, because the data behind them carries no redistribution licence (two prediction consensus and divergence methods, two options divergence methods, crypto options and stablecoins). Later versions only add methods and parameters.

Set KRESMION_API_KEY in your environment (or pass the key when you create the client), then call the methods.

Excel add-in

Live Kresmion values in spreadsheet cells, in Excel for Windows and Mac and in Excel for the web.

1. In Excel: Insert › Get Add-ins › Upload My Add-in, and select the manifest.
2. Open the Kresmion taskpane, paste your API key (krm_...) and click Connect.
3. Type a function in any cell, for example =KRESMION.REGIME().

• 25 worksheet functions, each prefixed KRESMION.: REGIME (regime label, score or conviction), SIGNAL (latest event for a ticker), PRICE (last close and day change), FRED and FREDH (a curated FRED series, latest or on a past date), WHALE (on-chain whale activity), BIS (a BIS country indicator), FILING (filing metadata or an extracted fundamental), FIN (a line of a company's standardised financial statements), OSINT (event count for a keyword), LIQUIDITY and NETLIQ (Fed net liquidity), ONCHAIN_RISK (on-chain risk score), SMARTMONEY (smart-money composite, signed from -100 to +100), CONFLUENCE (active cross-family confluence), HOLDERS13F (13F holders at the latest quarter), SHORTINTEREST (short interest as a percentage of float, from FINRA), TRACKRECORD (median forward return after an event type), FUNDING (latest perpetual funding rate), CBRATE (a central bank policy rate), YIELD (a Treasury curve point, today or on a past date), MMRATE (a money-market rate with the Fed corridor), RV (a relative-value metric against the peer median), IPO (the newest EDGAR offering filing) and ESI (the Economic Surprise Index).
• The taskpane has five blocks: Connection (key field, Connect, Disconnect), Status (Test connection, Clear cache), Field search (search every field, series and function with its live universe; click a formula to copy it), Quick reference (Function, Example, Returns; click an example to copy it) and Templates (Insert Portfolio Dashboard and Insert Regime Monitor drop a pre-built block into the active sheet).
• Messages in a cell: "Invalid or revoked API key. Reconnect in the taskpane.", "Rate limit exceeded. Wait a minute or upgrade your plan.", and, for a function your access does not include, "Subscription required. Upgrade at kresmion.com/pricing." Some functions return a reason as text instead of a number (for example a refused relative-value cell) or leave a blank when a value is unknown.

Your key is stored with your Microsoft account's Office settings, so it follows you between Excel installs. The taskpane's API keys page link opens API keys. Ready-made spreadsheets that use these functions are at the bottom of the risk models tool (Cmd-K XLTP). The functions and their exact names are also listed in the Field registry under Excel.

Field registry

Finding the exact field, FRED series, spreadsheet path or Excel function that carries a number, with its source, the ways you can get it, and how much data stands behind it. The same list is available as GET /v1/fields and as the MCP tool field_search.

• Catalogs (left rail), each with its own colour and a count (matching / total): All, Screener (typed fields you can filter and sort on with /v1/screen), FRED (curated FRED series with units), Excel (KRESMION.* worksheet functions), Sheet path (dotted paths for =KRESMION(entity, path)) and Caveat (data disclosures returned under meta.caveats).
• A count line: "N matches in <catalog>", "first 400 shown" when there are more, and how many fields are not listed because their source terms do not permit redistribution.
• The table: Field (the key and the registry id, each with a copy button, the catalog and kind, and the readable label), Description, Type / unit, Source, Doors (the ways it is served: API, MCP, Excel, sheet), and Universe (how many rows or symbols it covers, and "to <date>" for the latest observation).
• Footnote: universe counts are computed against the table each field is read from and refresh every 15 minutes; the page is metadata only.

• Type in the filter box ("Filter as you type, e.g. treasury yield, short interest"); press / to focus it. Every word must appear in the field's id, key, label, description, source or unit; matches are highlighted. Clear empties it.
• Click a catalog to narrow the list. The search and catalog are kept in the address (?q=&catalog=).
• Click a copy button to copy a key or id.
• Empty: "No field matches "<words>" in <catalog>. Every word must appear in the field's id, key, label, description, source or unit." If the registry cannot be reached: "The registry is unavailable right now."

A catalog link reloads the page filtered to that catalog; nothing else leaves the page.

Where to find it

• Learn what Kresmion is in two minutes → / (Landing page)
• Read the public site in French, Spanish, Korean, Turkish, Chinese or Arabic → the language pill in the header (Languages)
• Search for a ticker or page without an account → Search or ⌘K on a public page (Search on the public site)
• Stop the email card from appearing → No thanks, just browsing (Sign-up card)
• Get the next research note by email → the sign-up card or the card under an article (Sign-up card)
• Find out how a number is computed → /about/methodology (Methodology)
• Check how often a source updates → Methodology › Update frequencies, /about/methodology#update-frequencies
• See who publishes the research and how to ask for a correction → /about (About)
• See the plans Kresmion moves to when billing opens → /pricing (Pricing)
• Report a wrong number or a bug → /support, email inquiry@kresmion.com (Support)
• Read central bank and regulator headlines → /newsroom, Cmd-K NI (Newsroom)
• Find an explainer on a concept (gamma, 13F, yield curve) → /learn, Cmd-K LEARN (Learn library)
• See today's value of what an explainer explains → the Current reading box or See it live on the article (Learn article)
• Download this guide as a PDF → /guide › Download the PDF (User Guide)
• Link someone to one section of this guide → /guide/<chapter>#<section> (User Guide chapter)
• Read the Terms, Privacy or Accessibility statement → the footer (Legal pages)
• Read the rules for using the API → /api-terms (API terms)
• Connect Claude or ChatGPT to Kresmion → /developers#connect (Connect Claude or ChatGPT)
• Disconnect an assistant → /settings/connected-apps (Connected apps)
• Get an API key → /settings/api-keys (API keys)
• Make a first API call → /developers#quickstart (REST API)
• Look up an endpoint and its parameters → /developers#reference (REST API)
• Know the monthly and per-minute API limits → /developers#limits (Rate limits)
• Lock a key to your server's IP address → API keys › Restrict to specific IPs (API keys, Rate limits and key rules)
• Understand an API error → /developers#errors (Errors and attribution)
• Know which credit line to show with FINRA or sovereign spread data → /developers#attribution (Errors and attribution)
• Find the id a route expects for a company or series → GET /v1/search?q= (Errors and attribution)
• Receive whale transfers or regime changes at your own server → /settings/webhooks (Webhooks)
• Verify a webhook signature → /developers#webhooks (Webhooks)
• Add Kresmion to Claude Code or Claude Desktop with a key → /developers#mcp (MCP server)
• Run the MCP server on your own machine → /sdk/kresmion_mcp.py (Local stdio server)
• Use Kresmion from Python → pip install kresmion (Python SDK)
• Pull live values into Excel → the manifest at /excel-addin/manifest.xml (Excel add-in)
• Find which field or Excel function carries a number → /developers/fields (Field registry)
• Open a portfolio someone shared with you → their /share/<token> link (Shared portfolio composition)
• Find the public research, notes, briefs, odds and tools pages → Other public pages