Fruit StandFruit Stand
  • Pricing
  • Documentation
  • API Reference
  • Pricing
Information
Meta
    HealthzgetGlama connector claimgetAPI catalog (RFC 9727)get
Funds
    Search fundsgetGet fund metadataget
Returns
    Get trailing returns (one fund)getGet trailing returns (many funds)postGet calendar-year return (one fund)getGet calendar-year returns (many funds)post
MCP
    Fund Returns MCP ServerMCP
Schemas
powered by Zuplo
Fruit Stand Fund Returns API
Fruit Stand Fund Returns API

Funds

Search the universe of ~32,000 US mutual funds and ETFs and fetch fund metadata by ticker.


Search funds

GET
https://api.fruitstand.dev
/v1/funds

Search the ~32,000 US mutual funds and ETFs by name or ticker to get the code the other tools need. Returns fund metadata only — name, type (ETF or FUND), exchange, currency, ISIN, and the date range with return data — plus next_cursor for keyset paging. No performance figures here; use getTrailingReturns / getCalendarReturns for those.

Search funds › query Parameters

q
​

Case-insensitive substring match on ticker or fund name (e.g. vanguard 500, SPY). Omit to list every fund.

type
​

Filter by security type: ETF or FUND (mutual fund). Matched exactly.

country
​

Filter by domicile country as stored (e.g. USA). Exact match.

exchange
​

Filter by listing exchange as stored (e.g. NYSE ARCA, NASDAQ). Exact match.

cursor
​

Keyset pagination cursor: the next_cursor from the previous response. Omit for the first page.

limit
​integer · min: 0

Page size, 1–1000. Defaults to 100.

Default: 0

Search funds › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search funds › Responses

Successful Response

FundList
​Fund[] · required
​

Pass as ?cursor= to fetch the next page. Null when no more.

GET/v1/funds
curl https://api.fruitstand.dev/v1/funds \ --header 'Authorization: Bearer <token>'
Example Responses
{ "data": [ { "code": "code", "market": "US", "name": "string", "country": "string", "exchange": "string", "currency": "string", "type": "string", "isin": "string", "is_inactive": true, "inactive_date": "2024-08-25", "min_return_date": "2024-08-25", "max_return_date": "2024-08-25" } ], "next_cursor": "string" }
json
application/json

Get fund metadata

GET
https://api.fruitstand.dev
/v1/funds/{code}

Fetch one fund's metadata by ticker (code): name, type (ETF or FUND), exchange, currency, ISIN, active/inactive status, and the date range for which return data exists. Returns 404 if the ticker is unknown. Use searchFunds to resolve a name to a code; use the returns tools for performance.

Get fund metadata › path Parameters

code
​string · required

The fund's bare ticker, case-sensitive — e.g. SPY, QQQ, VTSAX. If you only have a name, resolve it with searchFunds first.

Get fund metadata › query Parameters

market
​string

Market/exchange code for the fund. Defaults to US — all funds are currently US-listed and code is a bare ticker (e.g. SPY), so this is informational and does not affect lookups. Reserved for future multi-market support.

Default: US

Get fund metadata › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get fund metadata › Responses

Successful Response

Fund
code
​string · required

Bare ticker, e.g. SPY.

market
​string

Market/exchange code. Always US for now.

Default: US
​
​
​
​
​
​
​
​
​
​
GET/v1/funds/{code}
curl https://api.fruitstand.dev/v1/funds/:code \ --header 'Authorization: Bearer <token>'
Example Responses
{ "code": "code", "market": "US", "name": "string", "country": "string", "exchange": "string", "currency": "string", "type": "string", "isin": "string", "is_inactive": true, "inactive_date": "2024-08-25", "min_return_date": "2024-08-25", "max_return_date": "2024-08-25" }
json
application/json

MetaReturns