Fume API Reference
Endpoints, parameters and response shapes of the public Fume API: the tokenized fund registry, the fund service provider catalog, and the site's submission endpoints.
The machine-readable version of this page is the OpenAPI 3.1 document at /openapi.json (mirrored at /api/openapi.json). It is the source of truth; this page is the readable summary.
Base URL: https://www.fume.finance. No authentication. Read endpoints allow any origin and are cached at the edge for an hour.
Read the tokenized fund registry
GET /api/registry/funds
Lists the funds in the Tokenized Fund Registry with strategy, AUM, chain, token standard, fees, jurisdiction and named service providers.
| Parameter | Type | Notes |
|---|---|---|
chain | string | Exact match, case-insensitive. Ethereum, Base, … |
status | string | Open, Closed, Upcoming, Soft Close, Hard Close, Launching |
assetClass | string | Exact match, case-insensitive |
jurisdiction | string | Exact match, case-insensitive |
q | string | Substring search over name, manager, issuer, strategy, description |
limit | integer | Default 50, max 200. Out-of-range values are clamped, not rejected |
offset | integer | Default 0 |
curl -s "https://www.fume.finance/api/registry/funds?chain=Base&status=Open&limit=5" | jq '.total, .funds[].name'Returns { total, limit, offset, funds[] }. Every fund carries url, the canonical page to cite, and dataSource, which says whether the record was verified onchain, taken from a public filing, or self-reported.
GET /api/registry/funds/{id}
One fund by its registry slug — the same slug as /registry/{id}.
curl -s https://www.fume.finance/api/registry/funds/blackrock-buidl | jq .nameUnknown ids return 404 with code: "fund_not_found".
Read the fund service provider catalog
GET /api/fund-builder/providers
Every provider listed in Fund Builder: legal counsel, fund administrators, custody, exchanges and brokers, auditors, management companies and insurance.
| Parameter | Type | Notes |
|---|---|---|
category | string | legal, fund-admin, custody, broker, auditor, aifm, insurance |
q | string | Substring search over name, description, specialty, tags, jurisdictions |
limit | integer | Default 100, max 200 |
offset | integer | Default 0 |
curl -s "https://www.fume.finance/api/fund-builder/providers?category=custody" | jq '.providers[].name'Returns { total, limit, offset, categories[], providers[] }. The categories array is always the full list, so one call is enough to discover every valid category value.
GET /api/fund-builder/providers/{id}
One provider by its catalog slug. Unknown ids return 404 with code: "provider_not_found".
Search the documentation
GET /api/search?query=…
Full-text search over /docs, returning ranked page, heading and text fragments. For bulk ingestion prefer /llms-full.txt, which is the entire corpus in one request.
Submission endpoints
These deliver a message to the Fume team. They accept POST with a JSON body and return { "success": true }.
| Endpoint | Required fields |
|---|---|
/api/contact | name, email, message |
/api/newsletter | email |
/api/consulting-inquiry | name, email |
/api/fund-builder/stack-submission | email |
/api/fund-builder/introduction-request | email, providerName |
/api/fund-builder/partner-listing | companyName, email, category |
/api/registry/document-request | fundId, name, email |
/api/registry/list-fund | fundName, contactName, email, strategy, chain |
In production each one also requires a captchaToken — a Google reCAPTCHA v3 token, which only a browser session can produce. They exist for the forms on this site. If you are an agent trying to reach us, email info@fume.finance. The full field list for each endpoint is in /openapi.json.
Status codes
| Status | code | Meaning |
|---|---|---|
| 400 | missing_required_field | A required field was absent |
| 400 | invalid_email | The email field is not a valid address |
| 400 | invalid_json | The body did not parse as JSON |
| 404 | fund_not_found / provider_not_found | No record with that id |
| 404 | unknown_endpoint | No such endpoint under /api |
| 405 | method_not_allowed | Wrong method; the Allow header names the right one |
| 500 | upstream_error | The request was fine, a downstream service was not. Retry |
Every one of them returns the same JSON envelope described in the developer overview.
🛠️ Developers
The Fume developer surface: the public REST API, the OpenAPI specification, markdown representations of every page, and the machine-readable indexes.
Agent Access to Fume
How an AI agent reads fume.finance: markdown content negotiation, llms.txt, the sitemap, raw-markdown URLs, and what a 404 tells you.