Finks Agents API: hosted financial agents for your app
Ship financial AI features faster. Hand off a question, and a Finks agent searches, reads, and answers, with every claim quoting its source.
Prepare me for my meeting with a client who holds Apple, JPMorgan, and Exxon Mobil. What changed since we last met in August?
All three holdings reported since August: Apple grew revenue 12%, JPMorgan earned $15.3 billion through a securities loss, and Exxon returned $9.4 billion to shareholders.Apple 8-KJPM 8-KXOM 8-K
Apple
- Results: fiscal fourth-quarter revenue rose 12% to $114.5 billion, and diluted EPS rose 14% to $2.10Apple 8-K.
- Tariff refunds: added about 1 point to gross margin and $0.05 to EPSApple 8-K.
- Income and debt: a $0.27 dividend is payable November 16Apple 8-K, and Apple sold $7.5 billion of notes on November 9Apple notes.
JPMorgan
- Results: third-quarter net income was $15.3 billion, or $15.8 billion excluding $658 million of securities lossesJPM 8-K.
- Credit: the provision for credit losses was $2.7 billion, including a $539 million reserve buildJPM 8-K.
- Wealth: assets under management reached $5.2 trillion, up 13%JPM 8-K.
Exxon Mobil
- Results: third-quarter earnings were $15.4 billion, with $25.7 billion of operating cash flowXOM 8-K.
- Shareholder returns: $9.4 billion returned in the quarter, a $1.07 dividend payable December 10, and $20 billion of buybacks planned for 2027XOM 8-K.
- Refining: Exxon reported record year-to-date refining performanceXOM 8-K.
Building an agent yourself
A financial agent needs tools, a loop that runs them, and a check on what it writes.
- 01Wire up the toolsSearch, read, and screen each need a schema, a client, and error handling.
- 02Run the loopPlan the steps, call the tools, read the results, and know when to stop.
- 03Check every claimMatch each sentence to a source before a user sees it.
Finks runs that loop for you: one call returns an answer with every claim quoting its source.
What a run returns
Every step the agent took, then an answer whose claims each quote what it read.
- 1statusRunning, then succeeded or failed
- 2traceEach step the agent took
- 3answer.textThe answer
- 4claimsEach claim, with the source text it quotes word for word
Response
{ "research_id": "rsch_…",1 "status": "succeeded",2 "trace": [ { "step": 1, "label": "…", "route": "/v1/search", "status": 200 }, … ], "answer": { "found": true,3 "text": "…",4 "claims": [ { "text": "…", "citations": [{ "title": "…", "quote": "…" }] }, … ] }}
Put an agent on every workflow
Fintech and brokerage apps
Answer users' questions about any company, inside your app.
Wealth platforms
Hand off meeting prep and client updates.
Research teams
Get a cited first pass on any company.
Connect the Finks MCP server or API in minutes
Add the Finks MCP server to Claude, ChatGPT, Cursor, or any MCP client, or call the REST API from your product.
AI apps
Paste one URL into Claude, ChatGPT, or Grok and sign in.
Coding agents
One command adds Finks to Claude Code, Codex, or Gemini CLI.
REST API
One key and one request return cited results to your product.
Get set up in minutes on the free tier.
Questions about the Finks Agents API
What is the Finks Agents API?
A hosted agent for financial questions. POST /v1/research takes a question; Finks searches its data, reads what it needs, and returns an answer whose claims each quote their source.
How is it different from the Search API?
POST /v1/search returns ranked results for your own agent to reason over. POST /v1/research runs the agent for you and returns the finished answer.
How long does a run take?
Fast mode usually takes about a minute; Research mode reads more and takes up to two minutes. Poll GET /v1/research/{research_id} every two seconds until it finishes.
How do I know the answer is right?
Each claim carries citations that quote the text Finks served, word for word, and the run checks those quotes before it writes the answer.
Is it available now?
The Agents API is in beta. Talk to us for access.
Put Finks agents in your product
The Agents API is in beta. Talk to us for access, or start free with search.