WritersLogic Verifiable AI Agent Hub Cover Claim API
The Cover Claim API from WritersLogic Verifiable AI Agent Hub — 1 operation(s) for cover claim.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/writerslogic-com:writerslogic-com-cover-claim-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: WritersLogic Verifiable AI Agent Hub Cover Claim API
version: 2.0.0
description: Pay-per-call agents settled in USDC on Base via x402. Every response carries a signed provenance envelope.
contact:
name: WritersLogic
url: https://writerslogic.com/agents
email: agents@writerslogic.com
servers:
- url: https://agents.writerslogic.com
tags:
- name: Cover Claim
paths:
/api/v1/cover-claim:
post:
operationId: cover_claim
summary: DeFi Cover Claim Adjudicator
description: 'Predicts whether a DeFi cover claim (Nexus Mutual or any provider''s wording) will be approved and for how much. Reads the wording, postmortems and the claimant''s transactions, quantifies net token loss with Chainlink prices at the loss block, maps facts to covered events, exclusions and conditions with verbatim verified clauses, cites similar past claims, and returns verdict.action (FILE / FILE_WITH_MORE_EVIDENCE / DO_NOT_FILE) with calibrated P(approved), expected payout and filing value in the cover asset, an assessor vote (APPROVE/DENY/ABSTAIN) and the missing evidence that would change the verdict. A failed hard gate (cover period, filing window) is decided in code with no model call; if a model stage fails you still get the verified gates, timing and loss valuation as a partial result. Not financial or legal advice.
Price: 5.00 USDC on Base (x402).'
x-x402-price-usdc: '5.00'
x-x402-amount: '5000000'
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '5.00'
x-audience: crypto
x-sample-url: https://agents.writerslogic.com/api/v1/samples/cover-claim
security:
- x402: []
- apiKey: []
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- wording
- claimant
- cover
properties:
wording:
type: object
additionalProperties: false
description: 'The cover wording: a Nexus Mutual product (id or name), a URL (HTML or PDF), or pasted text. At least one.'
properties:
productId:
type: integer
minimum: 0
maximum: 1000000
description: Nexus Mutual product id (api.nexusmutual.io/v2/products).
productName:
type: string
minLength: 2
maxLength: 200
description: Nexus Mutual product or product-type name, e.g. "Single Protocol Cover".
url:
type: string
minLength: 8
maxLength: 2000
description: Public URL of any provider's wording (PDF, HTML or text).
text:
type: string
minLength: 200
maxLength: 60000
description: Wording text; overrides the other fields.
incident:
type: object
additionalProperties: false
properties:
description:
type: string
minLength: 10
maxLength: 20000
postmortemUrls:
type: array
maxItems: 4
items:
type: string
minLength: 8
maxLength: 2000
occurredAt:
type: string
minLength: 10
maxLength: 40
description: ISO 8601 time the loss event began, if known.
transactions:
type: array
maxItems: 12
description: Transactions in which the claimant lost (or deposited, or recovered) funds.
items:
type: object
additionalProperties: false
required:
- chain
- hash
properties:
chain:
type: string
enum:
- ethereum
- base
- polygon
- arbitrum
- optimism
hash:
type: string
pattern: ^0x[0-9a-fA-F]{64}$
claimant:
type: string
pattern: ^0x[0-9a-fA-F]{40}$
description: Address that suffered the loss (the Impacted Account).
cover:
type: object
additionalProperties: false
required:
- amount
- asset
- start
- end
properties:
amount:
type: number
minimum: 0
maximum: 1000000000000
description: Cover amount in units of the cover asset.
asset:
type: string
minLength: 2
maxLength: 20
description: Cover asset symbol, e.g. ETH, USDC, DAI, cbBTC.
start:
type: string
minLength: 10
maxLength: 40
description: ISO 8601 cover start.
end:
type: string
minLength: 10
maxLength: 40
description: ISO 8601 cover end.
deductible:
type: object
additionalProperties: false
description: Overrides any deductible found in the wording. Amount in cover-asset units; percentages 0-100.
properties:
amount:
type: number
minimum: 0
maximum: 1000000000000
percentOfCover:
type: number
minimum: 0
maximum: 100
percentOfLoss:
type: number
minimum: 0
maximum: 100
basis:
type: string
enum:
- from_loss
- from_capped_loss
description: 'from_loss (default, Nexus clause 6): min(loss - deductible, cover). from_capped_loss: min(loss, cover) - deductible.'
claimedLoss:
type: object
additionalProperties: false
description: Loss the claimant asserts, in cover-asset units. Used for the payout only when no on-chain loss can be established; always reported as unverified.
properties:
amount:
type: number
minimum: 0
maximum: 1000000000000
required:
- amount
claimDate:
type: string
minLength: 10
maxLength: 40
description: ISO 8601 date the claim is (to be) filed; default now.
example:
wording:
productName: Pocket Universe
incident:
description: A transaction of about 2.08 ETH made on the Lido frontend on 2024-10-04 at 11:31:28 UTC was replaced with a plain transfer to a scam address by malware on the user's machine, and Pocket Universe did not flag it as malicious. The claimant cites covered event 3b, malicious sending of funds.
postmortemUrls:
- https://forum.nexusmutual.io/t/1538
occurredAt: '2024-10-04T11:31:28Z'
transactions:
- chain: ethereum
hash: '0x1b84e51a0b3f682ce7636170f9a18fcb3cc532661c1ce65f9733e2b5ce74a29f'
claimant: '0x760513ef6f45da1964128848f8962c02fb4770c9'
cover:
amount: 250000.23
asset: USDC
start: '2024-09-25T00:00:00Z'
end: '2024-10-25T00:00:00Z'
claimedLoss:
amount: 5027.91
claimDate: '2024-10-11T00:00:00Z'
responses:
'200':
description: Paid result with provenance
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
verdict:
type: object
description: Machine-readable call, computed in code. Leads the answer; detail follows in the other fields.
properties:
action:
type: string
enum:
- FILE
- FILE_WITH_MORE_EVIDENCE
- DO_NOT_FILE
reason_code:
type: string
description: Stable code for why this action was returned.
confidence:
anyOf:
- type: number
- type: 'null'
description: 0-1; null when no judgment was made.
confidence_label:
type: string
enum:
- low
- medium
- high
edge_bps:
anyOf:
- type: number
- type: 'null'
description: Expected edge in bps of cost; null when not priced.
edge_usd:
anyOf:
- type: number
- type: 'null'
description: 'Expected edge in USD (cover-claim: cover-asset units); null when not priced.'
size_usd:
anyOf:
- type: number
- type: 'null'
description: Suggested stake in USD; null when not sized.
headline:
type: string
drivers:
type: array
items:
type: string
next_step:
type: string
partial:
type: boolean
description: True when part of the analysis could not run; see missing.
missing:
type: array
items:
type: string
disclaimer:
type: string
description: Not financial advice.
partial:
type: boolean
description: 'True when the clause-map stage failed: clauses were not extracted, confidence is capped at 0.5 and missing names the stage. A failed probability ensemble is a 502 so the payment is released.'
missing:
type: array
items:
type: string
description: 'Stages that did not complete: clause_map.'
recommendation_assessor:
type: string
enum:
- APPROVE
- DENY
- ABSTAIN
description: Vote advice for a claim assessor.
recommendation_claimant:
type: string
enum:
- FILE
- FILE_WITH_MORE_EVIDENCE
- DO_NOT_FILE
refile_after:
anyOf:
- type: string
- type: 'null'
description: ISO time when the wording's cool-down ends, when filing is premature; otherwise null.
decided_by:
type: string
enum:
- deterministic_hard_gate
- model_ensemble
description: 'deterministic_hard_gate: a failed hard gate (filing deadline, cover period) decided the verdict in code with no model call.'
llm_calls:
type: integer
description: Number of model calls this answer used.
clause_map_source:
type: string
enum:
- none
- code_parsed
- model
description: Whether clauses and terms were read from the wording by code or by a model.
p_approved:
type: number
description: Calibrated probability the claim is approved (0-1).
p_interval:
type: array
items:
type: number
confidence:
type: number
description: 0-1; falls with ensemble disagreement, dropped quotes and decisive evidence gaps.
payout:
type: object
description: 'Cover-asset amounts: measured_loss, deductible, claim_amount_if_approved, expected_payout, claim_deposit, expected_value_of_filing.'
deciding_clauses:
type: array
items:
type: object
description: Covered-event, exclusion and condition clauses, each verified verbatim against the wording.
cleared_exclusions:
type: array
items:
type: object
gates:
type: array
items:
type: object
description: 'Deterministic checks: event within cover period, filing window, cool-down, materiality.'
timing:
type: object
losses:
type: array
items:
type: object
description: Per-token net flows of the claimant with Chainlink pricing at the loss block, or the reason a token is unpriced.
transactions:
type: array
items:
type: object
precedents:
type: array
items:
type: object
description: Most similar past Nexus Mutual claims with outcomes and verified excerpts.
missing_evidence:
type: array
items:
type: object
description: Evidence that would change the verdict.
ensemble:
type: object
red_team:
anyOf:
- type: object
- type: 'null'
description: Adversarial assessor pass arguing for denial; null when no model ran or the pass failed.
decisive_clause_quotes:
type: array
items:
type: string
reasoning:
type: array
items:
type: string
incident:
type: object
unverified_quotes_dropped:
type: integer
warnings:
type: array
items:
type: string
sources:
type: array
items:
type: object
_provenance:
type: object
description: C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance
required:
- data
- _provenance
'400':
description: Invalid request (no payment consumed)
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
'401':
description: Invalid X-API-KEY
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
'402':
description: Payment required or invalid
content:
application/json:
schema:
type: object
description: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)
properties:
x402Version:
type: integer
error:
type: string
code:
type: string
resource:
type: object
accepts:
type: array
items:
type: object
extensions:
type: object
'502':
description: Upstream failure; the payment is released or not settled
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
tags:
- Cover Claim
components:
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment payload (base64) sent after a 402 challenge
apiKey:
type: apiKey
in: header
name: X-API-KEY