@sperax/tool-vc-raises

Track crypto & DeFi fundraising rounds and VC investments via DefiLlama

VC Fundraising is an agent tool from SperaxOS, packaged headless so you can call it from any agent framework. It ships two things: the manifest — a JSON-Schema function definition a model can call — and the executor that runs the call against the real API.

There is no UI layer and no framework lock-in. It works anywhere TypeScript runs.

Install

npm install @sperax/tool-vc-raises

Usage

Call it directly

import { vcRaisesExecutor } from '@sperax/tool-vc-raises';

const result = await vcRaisesExecutor.invoke('getRecentRaises', {"category":"<category>","days":1}, {
  messageId: 'msg-1',
});

console.log(result.content); // prose summary written for the model to read
console.log(result.state);   // typed data payload for your own UI

Give it to a model

import Anthropic from '@anthropic-ai/sdk';
import { VcRaisesManifest, vcRaisesExecutor } from '@sperax/tool-vc-raises';

const client = new Anthropic();

const response = await client.messages.create({
  model: 'claude-opus-4-8',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Ask something this tool can answer' }],
  tools: VcRaisesManifest.api.map((api) => ({
    name: api.name,
    description: api.description,
    input_schema: api.parameters,
  })),
});

for (const block of response.content) {
  if (block.type !== 'tool_use') continue;
  const result = await vcRaisesExecutor.invoke(block.name, block.input, { messageId: response.id });
  console.log(result.content);
}

VcRaisesManifest.api is already in JSON-Schema form, so it maps onto any tool-calling API — Anthropic, OpenAI, the Vercel AI SDK, or an MCP server — without translation.

Every executor returns a BuiltinToolResult — { success, content, state }. content is prose written for the model to read; state is the typed data payload for your own code. Executors never throw: a failed call comes back as { success: false, content: '<reason>' }, so a network blip degrades the answer instead of crashing the agent loop.

Configuration

None. This tool calls a public API directly and needs no key or origin configuration.

Tool identifier

sperax-vc-raises

API reference

getRecentRaises

Get recent crypto/DeFi fundraising rounds. Optionally filter by category, time window, or minimum amount raised.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | category | string | no | Filter by category (e.g. "DeFi", "Infrastructure", "Gaming", "NFT", "L1", "L2"). | | days | number | no | Look back N days (default: 30). | | minAmount | number | no | Minimum fundraise amount in USD (default: 0). |

searchRaises

Search fundraising rounds by project name or investor name. Case-insensitive substring match.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | query | string | yes | Search query — project name (e.g. "Uniswap") or investor name (e.g. "a16z", "Paradigm"). |

getRaiseSummary

Get aggregate fundraising summary: total raised, round count, average size, top categories, and most active investors.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | days | number | no | Summarize the last N days (default: 30). |

Types

Shared types come from @sperax/agent-tools-core: BuiltinToolManifest, BuiltinToolResult, BuiltinToolContext, and the BaseExecutor class every tool executor extends.

Related

• @sperax/agent-tools-core — the tool contract
• All SperaxOS agent tools — tool-vc-raises is one of many
• SperaxOS — the agent workspace these tools were built for

License

Apache-2.0