Skip to main content
GET
/
v1
/
api-meta
/
markets
curl
curl https://api.testnet.arcus.xyz/v1/api-meta/markets
curl "https://api.testnet.arcus.xyz/v1/api-meta/markets?market=BTC-USD"
{
  "results": [
    {
      "ticker": "<string>",
      "tradingViewId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "website": "<string>",
      "logo": "<string>",
      "sector": "<string>",
      "ceo": {
        "name": "<string>",
        "title": "<string>",
        "since": "<string>"
      },
      "employees": 123,
      "headquarters": {
        "country": "<string>",
        "state": "<string>",
        "city": "<string>",
        "address": "<string>"
      },
      "founded": {
        "ipoDate": "<string>",
        "year": 123
      },
      "financials": {
        "marketCap": 123,
        "peRatio": 123,
        "dividendYield": 123,
        "currency": "<string>",
        "revenue": 123,
        "evToSales": 123,
        "evToEBITDA": 123,
        "priceToBook": 123
      },
      "quarterlyEarnings": [
        {
          "period": "<string>",
          "fiscalQuarter": "<string>",
          "epsActual": 123,
          "epsEstimate": 123,
          "epsSurprise": 123,
          "epsSurprisePercent": 123
        }
      ],
      "news": [
        {
          "publishedDate": "<string>",
          "title": "<string>",
          "publisher": "<string>",
          "site": "<string>",
          "text": "<string>",
          "url": "<string>",
          "image": "<string>"
        }
      ],
      "incomeStatements": [
        {
          "date": "<string>",
          "symbol": "<string>",
          "reportedCurrency": "<string>",
          "cik": "<string>",
          "filingDate": "<string>",
          "acceptedDate": "<string>",
          "fiscalYear": "<string>",
          "period": "<string>",
          "fiscalQuarter": "<string>",
          "revenue": 123,
          "costOfRevenue": 123,
          "grossProfit": 123,
          "researchAndDevelopmentExpenses": 123,
          "generalAndAdministrativeExpenses": 123,
          "sellingAndMarketingExpenses": 123,
          "sellingGeneralAndAdministrativeExpenses": 123,
          "otherExpenses": 123,
          "operatingExpenses": 123,
          "costAndExpenses": 123,
          "netInterestIncome": 123,
          "interestIncome": 123,
          "interestExpense": 123,
          "depreciationAndAmortization": 123,
          "ebitda": 123,
          "ebit": 123,
          "nonOperatingIncomeExcludingInterest": 123,
          "operatingIncome": 123,
          "totalOtherIncomeExpensesNet": 123,
          "incomeBeforeTax": 123,
          "incomeTaxExpense": 123,
          "netIncomeFromContinuingOperations": 123,
          "netIncomeFromDiscontinuedOperations": 123,
          "otherAdjustmentsToNetIncome": 123,
          "netIncome": 123,
          "netIncomeDeductions": 123,
          "bottomLineNetIncome": 123,
          "eps": 123,
          "epsDiluted": 123,
          "weightedAverageShsOut": 123,
          "weightedAverageShsOutDil": 123
        }
      ],
      "balanceSheets": [
        {
          "date": "<string>",
          "symbol": "<string>",
          "reportedCurrency": "<string>",
          "cik": "<string>",
          "filingDate": "<string>",
          "acceptedDate": "<string>",
          "fiscalYear": "<string>",
          "period": "<string>",
          "fiscalQuarter": "<string>",
          "cashAndCashEquivalents": 123,
          "shortTermInvestments": 123,
          "cashAndShortTermInvestments": 123,
          "netReceivables": 123,
          "accountsReceivables": 123,
          "otherReceivables": 123,
          "inventory": 123,
          "prepaids": 123,
          "otherCurrentAssets": 123,
          "totalCurrentAssets": 123,
          "propertyPlantEquipmentNet": 123,
          "goodwill": 123,
          "intangibleAssets": 123,
          "goodwillAndIntangibleAssets": 123,
          "longTermInvestments": 123,
          "taxAssets": 123,
          "otherNonCurrentAssets": 123,
          "totalNonCurrentAssets": 123,
          "otherAssets": 123,
          "totalAssets": 123,
          "totalPayables": 123,
          "accountPayables": 123,
          "otherPayables": 123,
          "accruedExpenses": 123,
          "shortTermDebt": 123,
          "capitalLeaseObligationsCurrent": 123,
          "taxPayables": 123,
          "deferredRevenue": 123,
          "otherCurrentLiabilities": 123,
          "totalCurrentLiabilities": 123,
          "longTermDebt": 123,
          "capitalLeaseObligationsNonCurrent": 123,
          "deferredRevenueNonCurrent": 123,
          "deferredTaxLiabilitiesNonCurrent": 123,
          "otherNonCurrentLiabilities": 123,
          "totalNonCurrentLiabilities": 123,
          "otherLiabilities": 123,
          "capitalLeaseObligations": 123,
          "totalLiabilities": 123,
          "treasuryStock": 123,
          "preferredStock": 123,
          "commonStock": 123,
          "retainedEarnings": 123,
          "additionalPaidInCapital": 123,
          "accumulatedOtherComprehensiveIncomeLoss": 123,
          "otherTotalStockholdersEquity": 123,
          "totalStockholdersEquity": 123,
          "totalEquity": 123,
          "minorityInterest": 123,
          "totalLiabilitiesAndTotalEquity": 123,
          "totalInvestments": 123,
          "totalDebt": 123,
          "netDebt": 123
        }
      ],
      "cashFlowStatements": [
        {
          "date": "<string>",
          "symbol": "<string>",
          "reportedCurrency": "<string>",
          "cik": "<string>",
          "filingDate": "<string>",
          "acceptedDate": "<string>",
          "fiscalYear": "<string>",
          "period": "<string>",
          "fiscalQuarter": "<string>",
          "netIncome": 123,
          "depreciationAndAmortization": 123,
          "deferredIncomeTax": 123,
          "stockBasedCompensation": 123,
          "changeInWorkingCapital": 123,
          "accountsReceivables": 123,
          "inventory": 123,
          "accountsPayables": 123,
          "otherWorkingCapital": 123,
          "otherNonCashItems": 123,
          "netCashProvidedByOperatingActivities": 123,
          "investmentsInPropertyPlantAndEquipment": 123,
          "acquisitionsNet": 123,
          "purchasesOfInvestments": 123,
          "salesMaturitiesOfInvestments": 123,
          "otherInvestingActivities": 123,
          "netCashProvidedByInvestingActivities": 123,
          "netDebtIssuance": 123,
          "longTermNetDebtIssuance": 123,
          "shortTermNetDebtIssuance": 123,
          "netStockIssuance": 123,
          "netCommonStockIssuance": 123,
          "commonStockIssuance": 123,
          "commonStockRepurchased": 123,
          "netPreferredStockIssuance": 123,
          "netDividendsPaid": 123,
          "commonDividendsPaid": 123,
          "preferredDividendsPaid": 123,
          "otherFinancingActivities": 123,
          "netCashProvidedByFinancingActivities": 123,
          "effectOfForexChangesOnCash": 123,
          "netChangeInCash": 123,
          "cashAtEndOfPeriod": 123,
          "cashAtBeginningOfPeriod": 123,
          "operatingCashFlow": 123,
          "capitalExpenditure": 123,
          "freeCashFlow": 123,
          "incomeTaxesPaid": 123,
          "interestPaid": 123
        }
      ]
    }
  ],
  "count": 1,
  "ingestedAt": 1
}
Returns curated reference data (company profile, branding, headline financials, TradingView chart identifiers, …) for one or all markets served by the api-meta service. The unfiltered set includes the api-gateway market universe plus curated RH spot/equity-like markets. Public — no X-API-Key and no signature required. Without ?market= the full set is returned; with ?market=<arcus market> (e.g. BTC-USD) the response is a single-row envelope. Data is refreshed in the background from the upstream reference feed roughly every 30 minutes; clients should cache downstream accordingly and use ingestedAt to bound staleness. Fields with no upstream source today (CEO, P/E ratio, dividend yield, quarterly earnings, country) serialize as null / []. See MarketMetadata for the full per-row contract.

Query Parameters

market
string

Optional arcus market filter (e.g. BTC-USD). When set, the response contains exactly the matching row or 404.

Response

Market metadata envelope (possibly empty results).

Envelope returned by GET /v1/api-meta/markets. Both the unfiltered list call and the single-market lookup (?market=) share this shape; a single-market hit has count == 1.

results
object[]
required
count
integer<int32>
required

Number of entries in results.

Required range: x >= 0
ingestedAt
integer<int64>
required

Newest ingested_at_ms (Unix milliseconds) across the returned rows. 0 when results is empty. Use this to bound client-side cache freshness.

Required range: x >= 0