In the Premium version of our API, there is the option to filter JSON response results by topic class, category, and other groupings. Our API only recognises specific values for these so-called slugs, so we've listed them below for reference.
You can find the latest topic classes, categories, and others on our Directory page, which may differ slightly from what is listed below if we are rapidly adding new topic classes.
Before listing all of them here, though, let's look at how to find the slug from our website.
topic_classes (includes asset classes)
This is a list of topic and asset classes available on our database. These are overarching topics and general forms of assets. Note that topics in the CityFALCON API vocabulary refer to specific entities, such as a person, organisation, company, or similarly singular idea. Topic classes are broader and more encompassing.
| alternative-dats | other-events |
| closed-end-funds | other-equity-securities |
| commodities | people |
| corporate-bonds | preferred-stocks |
| cryptocurrencies | private-companies |
| events* | products |
| funds | property |
| financial-topics | ratings-research-firms |
| fundamental-analysis | regulations |
| foreign-exchange | bonds** |
| indices | state-owned-companies |
| macro-topics | stocks |
| mutual-funds | technical-analysis |
| organisations |
* this slug represents our Major Business and Related Activities topic class
** this slug represents Government and Sovereign Bonds, not all bonds. Use the corporate-bonds slug for corporates.
events
These are important events like analyst ratings changes, earning announcements, IPO roadshows, strikes, and many others.
| accounting-and-audit-issues | crowdfunding | profit-warning |
| accounting-changes | default | protests |
| acquisitions | delistings | referendum |
| activist-investing | disasters | refinancing |
| analyst-downgrades-to-sell | disposals | regulatory-changes-and-issues |
| analyst-upgrades-to-buy | disputes | restructure |
| analyst-buy-rating | divestment | reverse-takeover |
| analyst-downgrades | dividend-cut | rights-issue |
| analyst-equal-weight-rating | dividend-announcements | riots |
| analyst-hold-rating | earnings | roadshows |
| analyst-initiate-coverage | ecb-monetary-policy-meeting | rumours |
| analyst-market-perform-rating | ecb-press-conference | russian-sanctions-rus |
| analyst-neutral-rating | economic-events | sales-and-purchase-agreement |
| analyst-outperform-rating | election-polls | sanctions |
| analyst-overweight-rating | elections | scams |
| analyst-price-target-decrease | environmental-social-governance | scandals |
| analyst-price-target-increase | equity-crowdfunding | sec-filings-and-other-news |
| analyst-ratings | exclusive-deals | seed-funding |
| analyst-sector-perform-rating | executives-churn | series-a-investing |
| analyst-sector-weight-rating | executives-management | series-b-investing |
| analyst-sell-rating | executives-new-hires | series-c-investing |
| analyst-strong-buy-rating | financial-crime | series-d-investing |
| analyst-strong-sell-rating | fines | series-e-investing |
| analyst-underperform-rating | fomc-minutes | series-f-investing |
| analyst-underweight-rating | fraud | series-g-investing |
| analyst-upgrades | geopolitical | series-h-investing |
| angel-investing | initial-coin-offerings | sexual-harassment |
| antitrust-issues | insider-activity | share-buyback |
| arbitration | insider-buying | sovereign-credit-ratings |
| asset-manager-changes | insider-selling | spinoffs |
| bankruptcy | insider-trading | stock-splits |
| block-sale | insolvency | stocks-short-selling-changes |
| bond-issuance | investing-in-start-ups | strikes |
| bonus-issues | investment-portfolio-changes | supply-chain-management |
| bribery | ipos | tax-changes-and-issues |
| business-failures | joint-ventures | trade-deal |
| business-expansion | layoff | trade-talks |
| capital-raising | legal-changes-and-issues | venture-capital-raising |
| cease-and-desist-orders | legal-settlements | whistleblower |
| class-action-suits | leveraged-buyout | white-collar-crimes |
| closure | market-manipulation | |
| community-investing | mergers | |
| company-guidance | mergers-acquisitions | |
| corporate-actions | money-laundering | |
| corporate-credit-ratings | negotiations | |
| corporate-performance | offload | |
| credit-rating-downgrades | partnerships | |
| credit-ratings | police-probe-reports | |
| credit-rating-upgrades | politics | |
| criminal-activity | products-projects-launches |