The Mithril API allows developers to programmatically fetch coverage quotes, check policy status, and integrate insurance directly into their DeFi frontends.
Authentication
Authentication is handled via Solana wallet signatures for write operations (like purchasing cover). Read operations (like fetching quotes) are public.
Base URL
https://api.mithril.protocol/v1
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mithril Insurance","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/pop-c0444c2a/s7OgHdhBOQL4-264/logo/light.svg?fit=max\u0026auto=format\u0026n=s7OgHdhBOQL4-264\u0026q=85\u0026s=7c407d4d7aad2fcbaa66621a215b9c21","dark":"https://mintcdn.com/pop-c0444c2a/s7OgHdhBOQL4-264/logo/dark.svg?fit=max\u0026auto=format\u0026n=s7OgHdhBOQL4-264\u0026q=85\u0026s=6762af776c98b1af06cc0a1176ce517e"},"favicon":"/favicon.svg","navbar":{"primary":{"type":"button","label":"Launch App","href":"https://mithril.insurance"}},"footer":{"socials":{"x":"https://twitter.com/mithrilinsure","github":"https://github.com/mithrilinsure"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"]},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Twitter","icon":"x","href":"https://twitter.com/mithrilinsure"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pop-c0444c2a","hasAudioNarration":false,"actualSubdomain":"pop-c0444c2a","customDomains":["docs.mithril.fyi"],"gitSource":{"type":"github","owner":"proxima424","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae945937a557f4aa9316bb4:success","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"Protocol","count":5},{"language":"default","tag":"Developers","count":3},{"language":"default","tag":"Roadmap","count":3},{"language":"default","tag":"Endpoints","count":2},{"language":"default","tag":"Integration","count":1},{"language":"default","tag":"Getting Started","count":1},{"language":"default","tag":"How It Works","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/introduction","slug":"/api-reference/introduction","pageMetadata":{"title":"Introduction","description":"Integrate Mithril insurance into your dApp","href":"/api-reference/introduction"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Integrate Mithril insurance into your dApp\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The Mithril API allows developers to programmatically fetch coverage quotes, check policy status, and integrate insurance directly into their DeFi frontends.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`Authentication is handled via Solana wallet signatures for write operations (like purchasing cover). Read operations (like fetching quotes) are public.`}),`\n`,_jsx(Heading,{level:`2`,id:`base-url`,children:`Base URL`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`https://api.mithril.protocol/v1`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Introduction","description":"Integrate Mithril insurance into your dApp","href":"/api-reference/introduction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Base URL","slug":"base-url","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"pop-c0444c2a","siteName":"Mithril Insurance","title":"Introduction - Mithril Insurance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-10T10:43:19.089Z","originalFileLocation":"api-reference/introduction.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Integrate Mithril insurance into your dApp\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mithril Insurance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Introduction - Mithril Insurance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Integrate Mithril insurance into your dApp\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mithril Insurance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mithril.fyi/api-reference/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pop-c0444c2a.mintlify.site/_mintlify/api/og/v2?division=Integration\u0026amp;title=Introduction\u0026amp;description=Integrate+Mithril+insurance+into+your+dApp\u0026amp;theme=a3de9b67c1e28f584f097fd4\u0026amp;signature=31db2c1bea5c82fef8d46c2783fcef4102d21d39ebc1ca56d3d388e0cc790285\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Introduction - Mithril Insurance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Integrate Mithril insurance into your dApp\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pop-c0444c2a.mintlify.site/_mintlify/api/og/v2?division=Integration\u0026amp;title=Introduction\u0026amp;description=Integrate+Mithril+insurance+into+your+dApp\u0026amp;theme=a3de9b67c1e28f584f097fd4\u0026amp;signature=31db2c1bea5c82fef8d46c2783fcef4102d21d39ebc1ca56d3d388e0cc790285\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/pop-c0444c2a/pwBE7HEfak8qnZd_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mithril Insurance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mithril.fyi/api-reference/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/introduction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mithril.fyi/#organization\",\"name\":\"Mithril Insurance\",\"url\":\"https://docs.mithril.fyi\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pop-c0444c2a/s7OgHdhBOQL4-264/logo/light.svg?fit=max\u0026auto=format\u0026n=s7OgHdhBOQL4-264\u0026q=85\u0026s=7c407d4d7aad2fcbaa66621a215b9c21\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mithril.fyi#website\",\"name\":\"Mithril Insurance\",\"url\":\"https://docs.mithril.fyi\",\"publisher\":{\"@id\":\"https://docs.mithril.fyi/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mithril.fyi/api-reference/introduction#webpage\",\"url\":\"https://docs.mithril.fyi/api-reference/introduction\",\"name\":\"Introduction\",\"description\":\"Integrate Mithril insurance into your dApp\",\"dateModified\":\"2026-01-10T10:43:19.089Z\",\"isPartOf\":{\"@id\":\"https://docs.mithril.fyi#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mithril.fyi/api-reference/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mithril.fyi/api-reference/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mithril Insurance\",\"item\":\"https://docs.mithril.fyi\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://docs.mithril.fyi/api-reference/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mithril.fyi/api-reference/introduction#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"Integrate Mithril insurance into your dApp\",\"url\":\"https://docs.mithril.fyi/api-reference/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mithril.fyi/api-reference/introduction#webpage\"},\"dateModified\":\"2026-01-10T10:43:19.089Z\",\"publisher\":{\"@id\":\"https://docs.mithril.fyi/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mithril.fyi#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mithril Insurance\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mithril Insurance\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/introduction.md","siteName":"Mithril Insurance","nav":{"global":{"anchors":[{"anchor":"Twitter","icon":"x","href":"https://twitter.com/mithrilinsure"}]},"tabs":[{"tab":"Protocol","pages":[{"title":"Protocol","href":""}]},{"tab":"Developers","groups":[{"group":"Integration","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"title":"Get Quote","openapi":"GET /quotes","description":"Returns a premium quote for a specific protocol and coverage amount.","href":"/api-reference/endpoint/get"},{"title":"Purchase Coverage","openapi":"POST /policies","href":"/api-reference/endpoint/create"}]}]}]},"basePath":"","title":"Introduction - Mithril Insurance","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":[],"chunks":[]}
