Dino

dino.markets API

Financial and economic data APIs for global and localized markets.

Finance & banking#finance

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Financial and economic data APIs for global and localized markets.

Endpoints 71

Calendars

  • GETGet Calendar Holidays On Date/v1/calendars/holidays/:country/on/:datePublished public holidays on one date. Returns 404 when no calendar is published for the country, year or scope.
  • GETGet Calendar Next Holiday/v1/calendars/holidays/:country/next?from_date=2024-01-01Next published public holiday on or after a date. Returns 404 when no calendar is published for the country, year or scope.
  • GETList Calendar Holidays/v1/calendars/holidays/:country/:yearPublished public holidays for a country and year, with the calendar coverage. An empty subdivision_codes list means the holiday applies nationwide. Returns…

Commodities

  • GETGet Commodity Spot/v1/commodities/spot/:commodity/:currency
  • GETGet Commodity Price History/v1/commodities/spot/:commodity/:currency/bars?start=2024-01-01T00:00:00Z&end=2024-01-01T00:00:00ZClosed price bars for one commodity and quote currency, from one minute to one day. A request may span at most 3 days of 1m bars, 14 days of 5m bars, 60 days…
  • GETList Commodity Spot/v1/commodities/spot
  • GETList Physical Series/v1/commodities/physical/seriesList physical price series: about 120 commodities across metals, battery materials, energy, fertilizer and chemical inputs, and agricultural goods, plus US…
  • GETGet Physical Series/v1/commodities/physical/series/:series_idDefinition of one physical price series: commodity, category, product, country, area, price type, basis, tax_included, currency, unit, unit_key,…
  • GETGet Physical Latest/v1/commodities/physical/series/:series_id/latestLatest published price of one physical price series.
  • GETGet Physical Observations/v1/commodities/physical/series/:series_id/observationsPublished prices of one physical price series. start is inclusive and end is exclusive. Supply start and end together.

FX

  • GETGet Fx Rates/v1/fx/rates/:base
  • GETGet Fx Rate History/v1/fx/rates/:base/observations?currencies=string&start_date=2024-01-01&end_date=2024-01-01
  • GETGet Fx Rate Bars/v1/fx/rates/:base/bars?currency=string&start=2024-01-01T00:00:00Z&end=2024-01-01T00:00:00ZClosed open-high-low-close bars for one currency against USD, from one minute to one day. A request may span at most 3 days of 1m bars, 14 days of 5m bars, 60…
  • GETConvert Fx/v1/fx/convert?from=string&to=string&amount=string

Economics

  • GETList Economic Releases/v1/economics/calendarRelease calendar entries for the chosen countries within a date window.
  • GETGet Economic Release/v1/economics/calendar/:release_idOne release calendar entry by release ID.
  • GETGet Cpi/v1/economics/:country/cpiLatest headline consumer price index for a country, or one period with period.
  • GETGet Policy Rate/v1/economics/:country/central-bank/policy-rate
  • GETGet Policy Rate History/v1/economics/:country/central-bank/policy-rate/history
  • GETGet Central Bank Reserves/v1/economics/:country/central-bank/reserves
  • GETGet Yield Curve/v1/economics/:country/yield-curveGovernment bond yield curve for one source date, in percent. curve_type shows how the country's source defines the curve. Omit date for the latest curve.
  • GETGet Yield Curve History/v1/economics/:country/yield-curve/historyGovernment bond yield curves by source date, oldest first, in percent.
  • GETGet Inflation/v1/economics/:country/inflationLatest headline inflation for a country, or one period with period.
  • GETGet Regional CPI/v1/economics/:country/regions/:region/cpiLatest headline consumer price index of one Malaysian state or federal territory. The United States has no regional CPI (404). index_base names the base, for…
  • GETGet Unemployment/v1/economics/:country/unemploymentLatest unemployment rate for a country, or one period with period.
  • GETGet Labour Force Participation/v1/economics/:country/labour-force-participationLatest labour-force participation rate for a country, or one period with period.
  • GETGet Gdp/v1/economics/:country/gdpLatest GDP at current prices for a country, or one period with period.
  • GETGet Gdp Growth/v1/economics/:country/gdp-growthLatest real GDP growth for a country, or one period with period.
  • GETGet Regional GDP/v1/economics/:country/regions/:region/gdpLatest GDP of one Malaysian state or federal territory (annual, constant 2015 prices, MYR) or one US state or DC (quarterly, current prices, seasonally…
  • GETGet Trade/v1/economics/:country/tradeLatest merchandise trade for a country, or one period with period.
  • GETGet Cpi History/v1/economics/:country/cpi/observationsThe headline consumer price index by period, oldest first.
  • GETGet Inflation History/v1/economics/:country/inflation/observationsThe headline inflation by period, oldest first.
  • GETGet Unemployment History/v1/economics/:country/unemployment/observationsThe unemployment rate by period, oldest first.
  • GETGet Labour Force Participation History/v1/economics/:country/labour-force-participation/observationsThe labour-force participation rate by period, oldest first.
  • GETGet Gdp History/v1/economics/:country/gdp/observationsThe GDP at current prices by period, oldest first.
  • GETGet Gdp Growth History/v1/economics/:country/gdp-growth/observationsThe real GDP growth by period, oldest first.
  • GETGet Trade History/v1/economics/:country/trade/observationsThe merchandise trade by period, oldest first.
  • GETRead Resource History/v1/economics/series/:series_id/observationsObservations of one economic series, oldest first.

Trade

  • GETSearch or list HS codes/v1/trade/hs-codesThe Harmonized System codes of one edition (2007, 2012, 2017 or 2022) at 2, 4 and 6 digits. q searches the names: chapters come first, then headings, then…
  • GETOne HS code with its children/v1/trade/hs-codes/:codeOne code of an HS edition: its name, level, parent and the codes one level down. A code that the edition does not have is not found.
  • GETWhat the trade routes hold for each country/v1/trade/coverageOne row per country: who answers the partners route and the products route (the country's own statistics office, other countries' reports, or UN Comtrade),…
  • GETOpen trade query over reporters, partners and products/v1/trade/flowsExports and imports for any reporters, partners and HS chapters (comma lists of up to 10), over every tier dino.markets holds: one row per reporter, month,…
  • GETA country's exports and imports by partner/v1/trade/:country/partnersGoods trade of one reporting country from its own customs office: one row per partner, month and flow. Without start and end the answer is the latest month.…
  • GETA country's exports and imports by product/v1/trade/:country/productsGoods trade of one reporting country from its own customs office, by HS product: level 2 (chapters), 4 (headings) or 6 (subheadings). partner limits it to one…
  • GETOne product's trade with every partner/v1/trade/:country/products/:hsOne HS code (2, 4 or 6 digits) of one reporting country: one row per partner, month and flow, with the code's name. Same options as the partners route. A code…

Equities

  • GETLatest prices for up to 50 stocks/v1/equities/prices?ids=stringLatest price of each listed id. One call is counted for each id that returns a price, taken in one step: if your balance cannot pay for the ids that resolved,…
  • GETTop US stock movers/v1/equities/moversThe top 25 US stocks and ETFs by direction: gainers, losers or active (most traded by value among the day's biggest gainers and losers, not the whole market).…
  • GETSearch stocks by ticker or name/v1/equities/search?q=stringListings whose ticker or name starts with q, any case: an exact ticker first, then other tickers, then names. Optional country (three letters) and type…
  • GETLatest price of one stock/v1/equities/:id/priceLatest price of one listing. change_percent is in percent. An unknown id is 404 not_found; a market without prices yet is 404 not_covered. Stock and fund…
  • GETDividends of one stock/v1/equities/:id/dividendsCash dividends of one listing, newest ex-date first, paged. The list may include announced future rows. Every account gets the full history. Upcoming rows are…
  • GETSplits of one stock/v1/equities/:id/splitsShare splits of one listing, newest first. Every account gets the full history. Upcoming rows are never cut. Each request counts one call. An unknown id is…
  • GETEarnings of one stock/v1/equities/:id/earningsPast earnings reports of one listing (dated today or earlier at the exchange), with estimate, actual and surprise, newest first, paged. Upcoming report dates…
  • GETMarket cap, P/E, P/S, P/B and dividend yield of one stock/v1/equities/:id/valuationMarket cap (latest price times shares outstanding), P/E (latest price over trailing 12-month diluted EPS from company filings, GAAP or IFRS as reported), P/S…
  • GETValuation history of one stock/v1/equities/:id/valuation/historyMarket cap, P/E, P/S, P/B and dividend yield at every fiscal period end (quarter or year end) of one US or Korean listing, oldest first. Each point is the…
  • GETPrice bars of one stock/v1/equities/:id/barsDaily (1d) or one-minute (1m) bars, oldest first, adjusted for splits and dividends. History: everything, for every account. One-minute bars reach back to…
  • GETProfile of one stock/v1/equities/:idThe listing (symbol, name, type, exchange, country, currency), the company's sector, industry and website, and company_id when the listing matches a company…

Funds

  • GETLatest prices for up to 50 funds/v1/funds/prices?ids=stringLatest price of each listed fund: an ETF's last price or a mutual fund's latest NAV. One call is counted for each id that returns a price, taken in one step:…
  • GETSearch ETFs and mutual funds by ticker or name/v1/funds/search?q=stringFunds whose ticker or name starts with q, any case: an exact ticker first, then other tickers, then names. Optional type (etf or mutual_fund) and country…
  • GETLatest price of one fund/v1/funds/:id/priceAn ETF's last price, in the stock price shape plus type: etf, or a mutual fund's latest NAV (type: mutual_fund: nav, previous_nav, change, change_percent and…
  • GETDistributions of one fund/v1/funds/:id/distributionsDistributions of one fund, newest ex-date first, paged. Every account gets the full history. Each request counts one call. An unknown id is 404 not_found.
  • GETPrice bars of one fund/v1/funds/:id/barsDaily (1d) or one-minute (1m) bars, oldest first, in the stock bar shape. A mutual fund's daily bar is its daily NAV (open, high, low and close are the NAV,…
  • GETProfile of one fund/v1/funds/:idThe fund's symbol, name, type (etf or mutual_fund), exchange (ETFs only), country and currency, as our symbol list holds them. Open to every account. Fields…

Company calendars

  • GETCompany dividends calendar/v1/calendars/dividendsDividends going ex in the window: the ex-date, the amount per share and its currency. start and end are inclusive days (YYYY-MM-DD); left out, start is today…
  • GETCompany splits calendar/v1/calendars/splitsStock splits taking effect in the window, with the ratio as new shares for old (4:1 gives four for one; 1:10 is a reverse split). start and end are inclusive…

Crypto

  • GETCrypto pairs we price/v1/crypto/pairsEvery pair we price, by pair (BTC-USD style). Optional quote (USD, EUR or GBP). A pair is listed while it trades at least once every 30 seconds and dropped…
  • GETLatest prices for up to 50 crypto pairs/v1/crypto/prices?pairs=stringLatest price of each listed pair. One call is counted for each pair that returns a price, taken in one step: if your balance cannot pay for the pairs that…
  • GETLatest price of one crypto pair/v1/crypto/:pair/priceThe latest composite price of a pair, with the 24-hour change (left out when it is not known). Crypto trades all day, so there is no market session; stale is…
  • GETPrice bars of one crypto pair/v1/crypto/:pair/barsDaily (1d, one UTC day, closing at 00:00 UTC) or one-minute (1m) bars, oldest first. A day's bar is out at 00:00 UTC; today's partial bar is never shown.…

Filings

  • POSTScreen Companies/v1/companies/screen
  • GETGet Screen Filters/v1/companies/screen/filters
  • POSTSearch Line Items/v1/companies/line-items

API details

Base URL
https://api.dino.markets
Authentication
A bearer token in the Authorization header
Operations
71 operations on 71 pathsGET 69POST 2
Main resources
Economics 24Equities 11Commodities 7Trade 7Funds 6Crypto 4FX 4Calendars 3Filings 3Company calendars 2
Response formats
application/problem+json application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the dino.markets API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the dino.markets API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get Calendar Holidays On Date” (GET /v1/calendars/holidays/:country/on/:date), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the dino.markets API?

Financial and economic data APIs for global and localized markets. It is listed under Finance & banking and has 71 endpoints.

Who publishes the dino.markets API?

It is listed from Dino's public API description (an OpenAPI document), not published by Dino on Swastik Codes. Anyone who controls dino.markets can claim the profile by adding a DNS TXT record.

What is the base URL of the dino.markets API?

Requests go to https://api.dino.markets. Endpoint paths are added to this base URL.

How do I authenticate with the dino.markets API?

With A bearer token in the Authorization header.

How many endpoints does the dino.markets API have?

71 operations on 71 paths (69 GET, 2 POST). The largest groups are Economics, Equities, Commodities, Trade.

Is forking the dino.markets API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.