Home · Developers
Financial dictionary API & MCP server
Free, read-only access to 4,113 finance and economics definitions in 36 language editions — for apps, researchers and AI agents. Works without a key (rate limited); free and paid API keys raise the limits. CORS enabled.
Get a free API key Pricing & plans
API keys & rate limits
| Plan | Requests / day | Price |
|---|---|---|
| Anonymous (per IP) | 100 | Free, no sign-up |
| Free key | 1,000 | Free |
| Pro | 50,000 | $19 / month |
| Business | 500,000 + bulk export | $99 / month |
| Enterprise & AI licensing | Custom | Contact |
Send your key as Authorization: Bearer abn_… or X-API-Key: abn_… (fallback: ?api_key=). The same header works on the MCP endpoint. Metered: search, define, single-term lookups, export, and MCP tools/call / resources/read / prompts/get. Static listings (terms.json, categories, index.json) are unmetered.
Metered responses carry X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix seconds; daily reset 00:00 UTC) and X-API-Tier. Over the limit returns 429 with Retry-After and a JSON body containing upgrade_url; an unknown or revoked key returns 401. GET /api/v1/usage shows your plan and usage without counting.
HTTP/1.1 429 Too Many Requests
Retry-After: 41234
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
{"error":{"code":"rate_limited","message":"Daily limit of 100 requests reached for anonymous access. …",
"tier":"anonymous","limit":100,"reset":1795305600,"upgrade_url":"https://abinomics.com/developers/pricing/"}}
Business and Enterprise keys can download a full edition: GET /api/v1/export?lang=en&format=ndjson.
MCP server
Remote Model Context Protocol server over Streamable HTTP. Stateless, JSON responses. Authentication is optional: anonymous clients get 100 tool calls a day per IP; add an Authorization: Bearer abn_… header for your plan's limit.
https://abinomics.com/mcp
Protocol versions: 2026-07-28 (stateless, per-request metadata, server/discover) and legacy initialize-based clients 2025-11-25, 2025-06-18, 2025-03-26.
| Tool | Arguments | Returns |
|---|---|---|
define_term | term, lang? | Best entry for a name or abbreviation (“ETF”, “APR”), with alternatives; tolerates small typos |
search_terms | query, lang?, limit? | Ranked matches with short definitions |
get_term | slug, lang? | Full entry by stable slug |
list_categories | lang? | Categories with counts |
browse_category | category, lang?, limit?, offset? | Terms in a category |
list_languages | — | Language codes, sites, translation coverage |
random_term | lang? | A random entry |
Also exposed: resources abinomics://languages, abinomics://terms/{lang}/{slug}, abinomics://categories/{lang}, and the prompt explain_term.
Claude Code
claude mcp add --transport http abinomics https://abinomics.com/mcp \
--header "Authorization: Bearer abn_YOUR_KEY"
Claude (claude.ai / Desktop)
Settings → Connectors → Add custom connector → URL https://abinomics.com/mcp. Connectors without custom headers use the anonymous tier.
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"abinomics": {
"url": "https://abinomics.com/mcp",
"headers": { "Authorization": "Bearer abn_YOUR_KEY" }
}
}
}
Omit headers to use the anonymous tier.
VS Code (.vscode/mcp.json)
{
"servers": {
"abinomics": { "type": "http", "url": "https://abinomics.com/mcp",
"headers": { "Authorization": "Bearer abn_YOUR_KEY" } }
}
}
ChatGPT and other clients
Add a remote MCP server / connector with the URL https://abinomics.com/mcp (optionally with the Authorization header), where your plan and client support custom connectors. Clients that only support local (stdio) servers can use a bridge such as npx mcp-remote https://abinomics.com/mcp.
Python (official MCP SDK)
With the official MCP Python SDK 2.x (pip install mcp):
import asyncio
from mcp.client.client import Client
async def main():
async with Client("https://abinomics.com/mcp") as client:
result = await client.call_tool("define_term", {"term": "ETF", "lang": "en"})
print(result.content[0].text)
asyncio.run(main())
Raw JSON-RPC
curl -s https://abinomics.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/call' -H 'Mcp-Name: define_term' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"define_term","arguments":{"term":"inflation"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'
HTTP API
Base URL https://abinomics.com/api/v1/. JSON, UTF-8, Access-Control-Allow-Origin: *, cacheable (ETag / Cache-Control). Listings and category files are static JSON; full entries and search are served from pre-built JSON snapshots by small read-only PHP handlers. No live database is queried. Machine-readable spec: OpenAPI 3.1.
| GET | Description |
|---|---|
/api/v1/index.json | Languages, counts, endpoint links |
/api/v1/define?term=ETF&lang=en | Look up by name or abbreviation (fuzzy, alias-aware; explicit ambiguity candidates) |
/api/v1/search?q=bond&lang=en&limit=10 | Ranked search with offset pagination |
/api/v1/{lang}/terms/{slug}.json | Full entry: definition, aliases, category, related terms, translations, canonical URL |
/api/v1/{lang}/terms.json | All terms in an edition (slug, name, short definition) |
/api/v1/{lang}/categories.json | Categories with counts |
/api/v1/{lang}/categories/{key}.json | Terms in one category |
lang is one of the 36 edition codes in index.json (e.g. en, es, de, fr, ja, zh-CN, zh-TW; Hebrew is iw, Filipino tl). Slugs are stable and identical across editions.
q/term: 1–200 characters. limit: 1–50; offset: 0–20,000. Name matching ignores case, accents and punctuation. Small-typo fuzzy matching is limited to Latin queries; other scripts support exact, prefix and substring matches. Unknown/invalid inputs return JSON errors (400/404); over-quota requests return 429 (see limits); infrastructure problems may return 503. Use backoff.
Example response
GET /api/v1/en/terms/exchange-traded-fund.json
{
"slug": "exchange-traded-fund",
"term": "Exchange-Traded Fund (ETF)",
"aliases": ["ETF"],
"lang": "en",
"definition": "…",
"category": {"key": "markets", "label": "Markets", "url": "…"},
"related": [ … ],
"translations": [{"lang": "es", "url": "…", "api_url": "…"}, …],
"translation": {"status": "original", "source_language": "en"},
"url": "https://abinomics.com/dictionary/exchange-traded-fund/",
"attribution": {"name": "Abinomics", "text": "Source: Abinomics (…)"}
}
Usage & citation
- Anonymous and free-key use is free; paid plans are listed on the pricing page. Please cite Abinomics with the entry’s
urlwhen you show a definition. - Free API access is not an open-content license. Source rights are retained; no blanket redistribution or model-training license is granted. A content license for wider reuse has not yet been specified.
- Check
translation.statuson non-English entries:original,curated,machine(machine translated — comparedefinition_en), orenglish-fallback(no translation yet; the text is English). - Prefer the unmetered static JSON snapshots for listing reads, respect caching headers, and keep concurrency modest — this runs on shared hosting with no SLA.
- Definitions are educational reference material, not financial advice. Legacy text may be outdated or contain errors. No professional accuracy audit or independent native-speaker verification is claimed.
- Most entries in non-English editions are still English fallbacks while translations are prepared. Translation coverage is reported by
list_languagesand/api/v1/index.json, not implied by the edition count.
Discovery files
- /llms.txt — summary for language models · /llms-full.txt — compact reference subset
- /.well-known/mcp.json — site-defined MCP discovery reference (not an official discovery standard) · /server.json — MCP server manifest
- /api/v1/openapi.json — OpenAPI 3.1 · /sitemap-index.xml — all language sitemaps