The Strise API

Is a GraphQL API, which allows for great flexibility for the user as he may specify the structure of the data retrieved. It's strongly typed making it ideal for code generation and type checking. To read more about GraphQL go to graphql.org/learn.

Since GraphQL is a query language and essentially transport protocol agnostic, you may contact the API by sending a GET or POST to https://graphql.strise.ai/graphql. To read more about the appropriate body or query variables click here.

Note that this is just a subset of the full functionality in the data platform. As a Strise.ai customer you get access to an API customized to your business needs

Start exploring the API at https://graphql.strise.ai/graphiql.

Query

Object

This is the root query type and as such will be your main entry-point to the Mito API when fetching data.

Fields

  • companyById(
    •   id: ID! Company ID.
    )
    : Company

    Given an internal Mito ID, you may retrieve a company at this field. If no matching company is found this field is null. The ID's can be found by using the other fields, such as Query.findCompanies.

  • findCompanies(
    •   q: String! Query string.
    •   first: Int = 10 Page size.
    )
    : CompanyConnection!

    Search for companies given a query string as the q argument. The number of potential companies returned is limited by the first argument, which is not required and defaulted to 10.

  • trendingCompaniesByIndex(
    •   index: Index! Market index.
    •   first: Int = 10 Page size.
    )
    : CompanyConnection!

    Find currently trending companies on a given market index. The indices are added on demand. The number of potential companies returned is limited by the first argument, which is not required and defaulted to 10.

  • trendingCompaniesBySector(
    •   sector: Sector! Industry sector.
    •   first: Int = 10 Page size.
    )
    : CompanyConnection!

    Find currently trending companies in a give sector based in the IPTC Media Topics. New sectors are added lazily on demand. The number of potential companies returned is limited by the first argument, which is not required and defaulted to 10.

  • cryptocurrencyById(
    •   id: ID! Cryptocurrency ID.
    )
    : Cryptocurrency

    Given an internal Mito ID, you may retrieve a cryptocurrency at this field. If no matching cryptocurrency is found this field is null. The ID's can be found by using the other fields, such as Query.findCryptocurrencies.

  • findCryptocurrencies(
    •   q: String! Query string.
    •   first: Int = 10 Page size.
    )
    : CryptocurrencyConnection!

    Search for cryptocurrencies given a query string as the q argument. The number of potential cryptocurrencies returned is limited by the first argument, which is not required and defaulted to 10.

  • trendingCryptocurrenciesByIndex(
    •   cryptoIndex: CryptoIndex! Crypto index.
    •   first: Int = 10 Page size.
    )
    : CryptocurrencyConnection!

    Find currently trending cryptocurrencies on a given market index. The indices are added on demand. The number of potential companies returned is limited by the first argument, which is not required and defaulted to 10.

Financials

Object

A representation of the financial data of a company, of a given year.

Fields

  • year: Int!

    The year of the financial data.

  • currency: Currency!

    The currency of the financial numbers.

  • operatingIncome: Float!

    Use operatingRevenue

    The operating income of the company.

  • operatingRevenue: Float!

    The operating revenue of the company.

  • operatingProfit: Float!

    The operating profit of the company.

  • operatingMargin: Float!

    The profit margin of the company.

  • profitMargin: Float!

    The profit margin of the company.

  • solvency: Float!

    Use equityRatio

    The solvency of the company.

  • equityRatio: Float!

    The equity ratio of the company.

  • interestCoverageRatio: Float!

    The interest coverage ratio of the company.

  • returnOnAssets: Float!

    The return on assets of the company.

  • EBITDA: Float!

    The EBITDA of the company.

  • taxesPaid: Float!

    The taxes paid of the company.

  • changeInWorkingCapital: Float!

    The change in working capital of the company.

  • estimatedCashflowFromOperations: Float!

    The estimated cashflow from operations of the company.

  • netInvestments: Float!

    The net investments of the company.

  • estimatedFreeCashflow: Float!

    The estimated free cashflow of the company.

  • changeInLoans: Float!

    The change in loans of the company.

  • changeInPaidUpEquity: Float!

    The change in the paid-up equity of the company.

  • dividendAndIntraGroupContribution: Float!

    The dividend income and intra-group contribution of the company.

  • estimatedNetCashflow: Float!

    The estimated net cashflow of the company.

  • financialIncome: Float!

    The financial income of the company

  • financialExpenses: Float!

    The financial expenses of the company

  • netCashFlow: Float!

    The net cash flow of the company

Address

Object

An object representing an address.

Fields

  • addressLine: String

    The address line of the address.

  • city: String

    The city of the address.

  • zipCode: String

    The zip code of the address.

CompanyConnection

Object

A connection of companies facilitating pagination of companies. To read more about connections, see the pagination documentation on graphql.org/learn/pagination/.

Fields

  • A list of edges containing the companies as nodes.

  • pageInfo: PageInfo!

    Page information, which can be used for page traversal.

CompanyConnectionEdge

Object

An edge in a company connection. To read more about connections, see the pagination documentation on graphql.org/learn/pagination/.

Fields

  • cursor: String!

    Cursor used for page traversal.

  • node: Company!

    The node containing a compny.

Cryptocurrency

Object

An object representing a cryptocurrency. From here you may currently access the base information, such as stories related to the cryptocurrency.

Fields

  • id: ID!

    The internal Mito ID of the cryptocurrency. Save this for fetching this object without searching for a cryptocurrency. This can be done with the Query.cryptocurrencyById field.

  • name: String!

    The name of the cryptocurrency.

  • website: String

    The official website of the cryptocurrency.

  • reddit: String

    The subreddit of the cryptocurrency.

  • twitterUsername: String

    The official twitter username. The corresponding twitter page should be https://twitter.com/{twitterUsername}.

  • stories(
    •   selection: StorySelection = RECENT Story selection.
    •   language: Language = ENGLISH Story language.
    •   first: Int = 10 Page size.
    )
    : StoryConnection!

    Stories related to this cryptocurrency. Depending on your selection and language, this may contain stories mentioning the cryptocurrency directly or something affiliated with the cryptocurrency. Read more about the different selections under the story selection enum.

CryptocurrencyConnection

Object

A connection of cryptocurrencies facilitating pagination of cryptocurrencies. To read more about connections, see the pagination documentation on graphql.org/learn/pagination/.

Fields

CryptocurrencyConnectionEdge

Object

An edge in a cryptocurrency connection. To read more about connections, see the pagination documentation on graphql.org/learn/pagination/.

Fields

StoryConnectionEdge

Object

An edge in an entity connection. To read more about connections, see the pagination documentation on graphql.org/learn/pagination/.

Fields

  • node: Story!

    Story as a node.

  • cursor: String!

    The current cursor. Use this for pagination.

  • relevant: Boolean!

    An indicator of whether the story is "relevant" for the given entity or not. A story can mention an entity, or related entity, without being relevant.

  • abstract: String!

    This is similar to the Article.abstract field, in that it is a sentence deemed relevant for the article. The only difference being that it is relevant in context of the parent entity.

StoryConnection

Object

A connection of stories facilitating pagination of stories. To read more about connections, see the pagination documentation on graphql.org/learn/pagination/.

Fields

  • A list of edges containing the stories as nodes and contextual information.

  • pageInfo: PageInfo!

    Page information, which can be used for page traversal.

Company

Object

An object representing a company. From here you may currently access the base information, such as title, and stories related to the company.

Fields

  • id: ID!

    The internal Mito ID of the company. Save this for fetching this object without searching for a company. This can be done with the Query.companyById field.

  • name: String!

    The name of the company.

  • website: String

    The official website of the company.

  • twitterUsername: String

    The official twitter username. The corresponding twitter page should be https://twitter.com/{twitterUsername}.

  • facebookProfileId: String

    The official facebook profile ID. The corresponding facebook page should be https://facebook.com/{facebookProfileId}.

  • ceo: String

    The official CEO of the company.

  • numberOfEmployees: Int

    The number of employees in the company.

  • organizationNumber: String

    The organization number of the company.

  • subsidiaryNames: [String!]!

    The subsidiaries of the company

  • parentCompanyNames: [String!]!

    The parent company of the company.

  • inception: ISODateTime

    The inception of the company.

  • yearsInOperation: Int

    The number of years the company has been in operation.

  • headquartersLocation: String

    The headquarters location of the company.

  • county: String

    The county of the headquarters of the company.

  • coordinates: String

    The coordinates of the headquarters of the company.

  • iptcIndustries: [String!]!

    IPTC industry the company operates in.

  • gicsCode: String

    The GICS industry code for the company.

  • naceCode: String

    The NACE industry code for the company.

  • naceName: String

    The NACE industry name.

  • phoneNumber: String

    The phone number of the company.

  • visitorAddress: Address!

    The visitor adress of the company.

  • quality: Boolean

    The quality of this company, indicating whether or not this company has been through QA

  • financials(
    •   from: Int = 2015 A year indicating from
    •   to: Int = 2017 A year indicating to
    )
    : [Financials]!

    The financial data of the company for a given time period.

  • stories(
    •   selection: StorySelection = RECENT Story selection.
    •   language: Language = ENGLISH Story language.
    •   first: Int = 10 Page size.
    )
    : StoryConnection!

    Stories related to this company. Depending on your selection and language, this may contain stories mentioning the company directly or something affiliated with the company. Read more about the different selections under the story selection enum.

Article

Object

This usually represents a news article which has been analyzed and linked by Mito.

Fields

  • title: String!

    The title of the news article.

  • abstract: String!

    The abstract is a sentence describing the content of the article. This is not contextual to anything other thant the article itself.

  • timestamp: String!

    Time of publication of the article in combined date and time ISO 8601 format.

  • publisher: String!

    The publisher of the article. Usually this is the website of the publicist.

Story

Object

A story is a collection of articles written about the same subject, i.e. a cluster of articles. Working with stories rather than articles provides a better overview of the media landscape by removing articles that, to some degree, are duplicates.

Fields

  • size: Int!

    The size is a number expressing how widely it has propagated the media. This is an indicator on the number of articles written about this story.

  • primaryArticle: Article!

    A story consists of several articles. This is the "best" article representing the story.

PageInfo

Object

Page info contains booleans which can be used for pagination.

Fields

  • hasPreviousPage: Boolean!

    This is true if backwards pagination is supported and there are more preceding pages.

  • hasNextPage: Boolean!

    Indicates if the last page has been reached.

Language

Enum

An enum representing supported languages.

Values

  • GERMAN

    German.

  • FRENCH

    French.

  • SPANISH

    Spanish.

  • DANISH

    Danish.

  • SWEDISH

    Swedish.

  • ENGLISH

    English.

  • NORWEGIAN

    Norwegian.

Sector

Enum

An enum containing the currently supported sectors based on the IPTC Media Topics.

Values

  • PHARMA

    This sector corresponds to the IPTC media topic: 'pharmaceutical'.

Index

Enum

An enum containing the currently supported market indices.

Values

  • DAX

    The DAX stock market index consisting of 30 major stocks traded on Frankfurt Stock Exchange.

    Read more on wikipedia

  • CAC

    The CAC 40 stock market index based on 40 of the highest market caps listed on Euronext Paris.

    Read more on wikipedia

  • OMXC

    The OMX Copenhagen 20 stock market index based on the 20 most-traded stocks on Copenhagen Stock Exchange.

    Read more on wikipedia

  • OMXS

    The OMX Stockholm 30 stock market index based on the market capitalizations of the 30 most-traded stocks on Stockholm Stock Exchange.

    Read more on wikipedia

  • OBX

    THE OBX stock market index based on the 25 most liquid companies listed on Oslo Stock Exchange.

    Read more on wikipedia

  • DJIA

    The Dow Jones Industrial Average (DJIA) stock market index based on the performance of 30 large companies on NYSE and NASDAQ.

    Read more on wikipedia

Currency

Enum

An enum representing supported currency.

Values

  • INR

    Indian rupee

  • SEK

    Swedish krona.

  • DKK

    Danish kroner.

  • EUR

    Euro.

  • USD

    United States Dollar.

  • NOK

    Norwegian kroner.

CryptoIndex

Enum

An enum containing the currently supported cryptocurrency indices.

Values

  • COINBASE

    The Coinbase index fund containing four major cryptocurrencies.

    Read more on Coinbase

StorySelection

Enum

An enum used to filter stories.

Values

  • RELEVANT

    Only stories deemed relevant to the company is fetched.

  • RECENT

    No filter is applied.

String

Scalar

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Int

Scalar

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

ISODateTime

Scalar

An combined date-time representation according to the ISO 8601 standard.

Boolean

Scalar

The Boolean scalar type represents true or false.

ID

Scalar

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Float

Scalar

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.