{"openapi":"3.1.0","info":{"title":"Artemis (BYOK) API","version":"0.1.0","description":"Artemis (BYOK) lets an AI assistant read your own Artemis data through the Artemis API with a key you supply (Artemis API key (Settings page at artemis.ai; needs a plan with API access)). Read-only: 12 tools (list_assets, list_supported_metrics, get_metrics, get_equity_financials, get_equity_valuation, get_equity_price, get_stablecoin_metrics, get_perps_metrics, get_prediction_market_metrics,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-artemis.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-artemis/docs"},"termsOfService":"https://connectorbay.com/byok-artemis/terms"},"servers":[{"url":"https://byok-artemis.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-artemis/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_assets":{"post":{"operationId":"list_assets","summary":"List every asset Artemis tracks (apps, chains, stablecoins and eq- prefixed equities) with the symbol to use elsewhere a","description":"List every asset Artemis tracks (apps, chains, stablecoins and eq- prefixed equities) with the symbol to use elsewhere and its sector tags. Unpaged and large. Use for \"What is the Artemis symbol for Hyperliquid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_assetsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_supported_metrics":{"post":{"operationId":"list_supported_metrics","summary":"List the metrics Artemis has for one asset symbol with label, unit, aggregation type, methodology and supported cuts. Us","description":"List the metrics Artemis has for one asset symbol with label, unit, aggregation type, methodology and supported cuts. Use for \"Which Artemis metrics exist for hype\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Asset symbol from list_assets, for example 'hype' or 'eq-coin'.","maxLength":60,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"list_supported_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_metrics":{"post":{"operationId":"get_metrics","summary":"Fetch daily time series for any comma-separated Artemis metric names and symbols over a date range, optionally rolled up","description":"Fetch daily time series for any comma-separated Artemis metric names and symbols over a date range, optionally rolled up. Errors arrive as a string in data. Use for \"What was Kalshi's open interest on 2026-08-01\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"metric_names":{"description":"Comma-separated uppercase metric names, for example 'OPEN_INTEREST,SPOT_VOLUME'. See list_supported_metrics.","maxLength":300,"title":"Metric Names","type":"string"},"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["metric_names","symbols","start_date","end_date"],"title":"get_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_equity_financials":{"post":{"operationId":"get_equity_financials","summary":"Quarterly income statement lines for public equities (revenue, net income, EBITDA, operating income, free cash flow, EPS","description":"Quarterly income statement lines for public equities (revenue, net income, EBITDA, operating income, free cash flow, EPS). Use eq- prefixed symbols; some companies do not report every line. Use for \"What was Coinbase's net income last quarter\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_equity_financialsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_equity_valuation":{"post":{"operationId":"get_equity_valuation","summary":"Daily valuation multiples for public equities: EV/revenue, EV/earnings, EV/EBITDA, EV/FCF, price/FCF, earnings yield and","description":"Daily valuation multiples for public equities: EV/revenue, EV/earnings, EV/EBITDA, EV/FCF, price/FCF, earnings yield and FCF yield. Use eq- prefixed symbols. Use for \"What is Nvidia's EV/EBITDA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_equity_valuationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_equity_price":{"post":{"operationId":"get_equity_price","summary":"Daily closing price for public equities. Use eq- prefixed symbols. Use for \"What did eq-meta close at yesterday\".","description":"Daily closing price for public equities. Use eq- prefixed symbols. Use for \"What did eq-meta close at yesterday\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_equity_priceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_stablecoin_metrics":{"post":{"operationId":"get_stablecoin_metrics","summary":"Stablecoin supply, transfer volume, daily active users and daily transactions. Use for \"How much USDC is in circulation\"","description":"Stablecoin supply, transfer volume, daily active users and daily transactions. Use for \"How much USDC is in circulation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_stablecoin_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_perps_metrics":{"post":{"operationId":"get_perps_metrics","summary":"Perpetual futures venue volume, open interest, fees and funding rate. Open interest is a snapshot and must not be summed","description":"Perpetual futures venue volume, open interest, fees and funding rate. Open interest is a snapshot and must not be summed. Use for \"What is Hyperliquid's perp volume\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_perps_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_prediction_market_metrics":{"post":{"operationId":"get_prediction_market_metrics","summary":"Prediction market venue volume, open interest, fees and active markets. Use for \"How big is Polymarket by volume\".","description":"Prediction market venue volume, open interest, fees and active markets. Use for \"How big is Polymarket by volume\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_prediction_market_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_chain_metrics":{"post":{"operationId":"get_chain_metrics","summary":"Blockchain daily active users, transactions, fees and revenue. Use for \"How many daily users does Solana have\".","description":"Blockchain daily active users, transactions, fees and revenue. Use for \"How many daily users does Solana have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_chain_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_lending_metrics":{"post":{"operationId":"get_lending_metrics","summary":"Lending protocol deposits, outstanding loans, borrow and lend APY and TVL. Use for \"What are Aave's deposits and borrows","description":"Lending protocol deposits, outstanding loans, borrow and lend APY and TVL. Use for \"What are Aave's deposits and borrows\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_lending_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_dex_metrics":{"post":{"operationId":"get_dex_metrics","summary":"Spot DEX volume, fees, daily users, transactions and TVL. Use for \"What is Uniswap's trading volume\".","description":"Spot DEX volume, fees, daily users, transactions and TVL. Use for \"What is Uniswap's trading volume\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbols":{"description":"Comma-separated Artemis asset symbols (lowercase), for example 'hype,aave' or 'eq-nvda,eq-coin'. Take them from list_assets.","maxLength":200,"title":"Symbols","type":"string"},"start_date":{"description":"Start date YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"End date YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"granularity":{"anyOf":[{"enum":["WEEK","MONTH","QUARTER","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional roll-up of the daily series.","title":"Granularity"}},"required":["symbols","start_date","end_date"],"title":"get_dex_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}