{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Abinomics Financial Dictionary API","version":"1.1.0","summary":"Read-only finance and economics definitions in 36 language editions.","description":"Listings and categories are static, unmetered JSON snapshots. Full entries, search, define and export are metered PHP endpoints. API keys are optional: anonymous 100/day per IP; free key 1,000/day; Pro 50,000/day; Business 500,000/day plus bulk export; Enterprise custom. Limits reset 00:00 UTC. Send keys as Authorization: Bearer, X-API-Key, or ?api_key=. Over the limit returns 429 with upgrade_url. Free keys: https://abinomics.com/developers/keys/ · Plans: https://abinomics.com/developers/pricing/. Entries include canonical URLs for citation and explicit translation status. Educational reference only; not financial advice."},"servers":[{"url":"https://abinomics.com/api/v1"}],"security":[],"externalDocs":{"description":"API and MCP documentation","url":"https://abinomics.com/developers/"},"paths":{"/index.json":{"get":{"operationId":"listLanguages","summary":"List language editions, counts, endpoint links and access rules","parameters":[],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/plans.json":{"get":{"operationId":"listPlans","summary":"Plans and daily limits","parameters":[],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/{lang}/terms.json":{"get":{"operationId":"listTerms","summary":"All term summaries in an edition (unmetered static snapshot)","parameters":[{"name":"lang","in":"path","required":true,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"]},"description":"Language edition code (case sensitive in static paths)."}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string"},"count":{"type":"integer"},"terms":{"type":"array","items":{"$ref":"#/components/schemas/TermSummary"}}}}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/{lang}/terms/{slug}.json":{"get":{"operationId":"getTerm","summary":"Full term definition, aliases, related terms and translation links","parameters":[{"name":"lang","in":"path","required":true,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"]},"description":"Language edition code (case sensitive in static paths)."},{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"description":"Stable term slug."}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Term"}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily limit reached. Get a key or upgrade (see error.upgrade_url).","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."},"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until reset."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}},"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]},{"apiKeyQuery":[]}]}},"/{lang}/categories.json":{"get":{"operationId":"listCategories","summary":"List categories and counts","parameters":[{"name":"lang","in":"path","required":true,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"]},"description":"Language edition code (case sensitive in static paths)."}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/{lang}/categories/{category}.json":{"get":{"operationId":"browseCategory","summary":"All term summaries in a category","parameters":[{"name":"lang","in":"path","required":true,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"]},"description":"Language edition code (case sensitive in static paths)."},{"name":"category","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Category key."}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/search":{"get":{"operationId":"searchTerms","summary":"Search names, aliases and definitions with ranked matches","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Term name, abbreviation or query (Unicode supported)."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"],"default":"en"},"description":"Language edition; see index.json. he/fil/nb aliases are also accepted by search/define."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":""},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":""}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"lang":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/TermSummary"}}}}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily limit reached. Get a key or upgrade (see error.upgrade_url).","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."},"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until reset."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}},"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]},{"apiKeyQuery":[]}]}},"/define":{"get":{"operationId":"defineTerm","summary":"Look up a term by name or alias (small Latin typos tolerated)","parameters":[{"name":"term","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Term name, abbreviation or query (Unicode supported)."},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"],"default":"en"},"description":"Language edition; see index.json. he/fil/nb aliases are also accepted by search/define."}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"lang":{"type":"string"},"ambiguous":{"type":"boolean"},"match_type":{"type":"string"},"term":{"anyOf":[{"$ref":"#/components/schemas/Term"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/TermSummary"}}}}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily limit reached. Get a key or upgrade (see error.upgrade_url).","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."},"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until reset."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}},"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]},{"apiKeyQuery":[]}]}},"/export":{"get":{"operationId":"exportEdition","summary":"Full dataset for one edition (Business/Enterprise keys)","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","af","ar","be","bg","ca","zh-CN","zh-TW","hr","cs","da","nl","tl","fi","fr","de","el","iw","hi","hu","is","id","ga","it","ja","ko","no","fa","pl","pt","ro","ru","sr","es","sv","th"],"default":"en"},"description":"Language edition; see index.json. he/fil/nb aliases are also accepted by search/define."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","ndjson"],"default":"json"},"description":""}],"responses":{"200":{"description":"Success","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"},"description":"* (public data)"},"Cache-Control":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."}},"content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string"},"generated":{"type":"string"},"terms":{"type":"array","items":{"$ref":"#/components/schemas/Term"}}}}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily limit reached. Get a key or upgrade (see error.upgrade_url).","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Daily request limit for your tier."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time (seconds) when the daily counter resets (00:00 UTC)."},"X-API-Tier":{"schema":{"type":"string"},"description":"anonymous, free, pro, business or enterprise."},"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until reset."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}},"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]},{"apiKeyQuery":[]}],"description":"Streams every full entry of an edition. Requires a key whose plan includes bulk export; other keys receive 403 plan_required. Counts as one request."}},"/usage":{"get":{"operationId":"getUsage","summary":"Your tier, daily limit and usage today (not counted)","security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]},{"apiKeyQuery":[]}],"responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"type":"object","properties":{"tier":{"type":"string"},"key_prefix":{"type":["string","null"]},"daily_limit":{"type":"integer"},"used_today":{"type":"integer"},"remaining":{"type":"integer"},"reset":{"type":"integer"},"reset_iso":{"type":"string"},"bulk_export":{"type":"boolean"}}}}}},"401":{"description":"Invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/keys":{"post":{"operationId":"createKey","summary":"Create a free API key (same-origin sign-up form; key shown once)","security":[],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["email","agree"],"properties":{"email":{"type":"string","format":"email"},"name":{"type":"string"},"use_case":{"type":"string"},"agree":{"type":"string"}}}}}},"responses":{"201":{"description":"Key created","content":{"application/json":{"schema":{"type":"object","properties":{"api_key":{"type":"string"},"key_prefix":{"type":"string"},"tier":{"type":"string"},"daily_limit":{"type":"integer"}}}}}},"400":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid request / resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"abn_<48 hex>","description":"Authorization: Bearer abn_..."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"apiKeyQuery":{"type":"apiKey","in":"query","name":"api_key","description":"Fallback only; headers keep keys out of logs and referrers."}},"schemas":{"Term":{"type":"object","required":["slug","term","lang","definition","url","translation"],"properties":{"slug":{"type":"string"},"term":{"type":"string"},"term_en":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"lang":{"type":"string"},"inLanguage":{"type":"string"},"definition":{"type":"string"},"definition_en":{"type":"string"},"short_definition":{"type":"string"},"category":{"type":"object"},"related":{"type":"array","items":{"type":"object"}},"translations":{"type":"array","items":{"type":"object"}},"translation_url_template":{"type":"string"},"translation":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["original","curated","machine","english-fallback"]},"source_language":{"type":"string"},"notice":{"type":"string"}}},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"license":{"type":"object"},"attribution":{"type":"object"}}},"TermSummary":{"type":"object","required":["slug","name","short_definition","url"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"short_definition":{"type":"string"},"category":{"type":"string"},"translation_status":{"type":"string"},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"}}},"RateLimitError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"const":"rate_limited"},"message":{"type":"string"},"tier":{"type":"string"},"limit":{"type":"integer"},"reset":{"type":"integer"},"retry_after":{"type":"integer"},"upgrade_url":{"type":"string","format":"uri"},"signup_url":{"type":"string","format":"uri"}}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}
