Developers
Query verified state, inspect how it changed, or stream transitions directly to an agent.
API referenceCreate API key
BASE URL
https://api.trincavelli.com/v1
DATA MODEL
State + transitions
STATUS
Operational
AUTH
Bearer token
QUICKSTART
Get a verified fact with history
Ask TD for the current value of a fact and receive the previous value, validity window, provenance, conflicts, and confidence in one object.
1 · AUTHENTICATE
Authorization: Bearer td_live_•••••••••••• Content-Type: application/json
2 · QUERY CURRENT STATETypeScriptcURL
const fact = await td.state.get({
entity: "NVDA",
field: "q4_revenue_guidance"
});3 · TEMPORAL KNOWLEDGE RESPONSE
{
"entity": "NVDA",
"field": "q4_revenue_guidance",
"current": 33.0,
"previous": 31.2,
"valid_from": "2026-09-29T10:42Z",
"previous_valid_until": "2026-09-29T10:42Z",
"confidence": 0.998,
"conflicts": [],
"sources": ["SEC_8K", "INVESTOR_RELATIONS"],
"evidence": [{ "source": "SEC_8K", "item": "2.02" }]
}Stream future transitions
Create a feed and TD will deliver the same state-transition object whenever the monitored fact changes or a source conflict appears.
await td.feeds.create({
entities: ["NVDA"],
trigger: "verified_state_change"
});YOUR API KEY
td_live_••••••••Copy
Keep this key server-side. Never expose it in client code.
USAGE
PlanDeveloper
Requests184 / 1,000
Feed deliveries36 / 250
Rate limit20 req/s
CORE ENDPOINTS
GET/state
GET/changes
POST/search
POST/feeds
MCP
Give an agent TD's knowledge model
Expose current state, change history, evidence, and source conflicts through one connection.
mcp.trincavelli.com Authorization: Bearer …