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

PlanRequests / dayPrice
Anonymous (per IP)100Free, no sign-up
Free key1,000Free
Pro50,000$19 / month
Business500,000 + bulk export$99 / month
Enterprise & AI licensingCustomContact

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.

ToolArgumentsReturns
define_termterm, lang?Best entry for a name or abbreviation (“ETF”, “APR”), with alternatives; tolerates small typos
search_termsquery, lang?, limit?Ranked matches with short definitions
get_termslug, lang?Full entry by stable slug
list_categorieslang?Categories with counts
browse_categorycategory, lang?, limit?, offset?Terms in a category
list_languages—Language codes, sites, translation coverage
random_termlang?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.

GETDescription
/api/v1/index.jsonLanguages, counts, endpoint links
/api/v1/define?term=ETF&lang=enLook up by name or abbreviation (fuzzy, alias-aware; explicit ambiguity candidates)
/api/v1/search?q=bond&lang=en&limit=10Ranked search with offset pagination
/api/v1/{lang}/terms/{slug}.jsonFull entry: definition, aliases, category, related terms, translations, canonical URL
/api/v1/{lang}/terms.jsonAll terms in an edition (slug, name, short definition)
/api/v1/{lang}/categories.jsonCategories with counts
/api/v1/{lang}/categories/{key}.jsonTerms 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

Discovery files