{ "openapi": "3.1.0", "info": { "title": "msfin API Reference", "version": "0.2.0", "description": "MarketScreener source API for bluedoor Financial Data.\nConsensus and financial table extraction from MarketScreener source pages.\nCoverage: Consensus estimates; Financial statement tables; Broker research context; Governance, news, and transcripts.\nGenerated from the live source contract and representative live API responses on 2026-06-07T01:30:59.456Z." }, "servers": [ { "url": "https://api.msfin.bluedoor.sh", "description": "msfin source API" } ], "externalDocs": { "description": "MarketScreener source API docs", "url": "https://bluedoor.sh/apis/financial-data/sources/msfin" }, "tags": [ { "name": "Calendars" }, { "name": "Company" }, { "name": "Consensus" }, { "name": "Financials" }, { "name": "News" }, { "name": "Research" } ], "paths": { "/v1/agenda-calendar": { "get": { "operationId": "msfin_get_agenda_calendar", "summary": "Agenda", "tags": [ "Calendars" ], "parameters": [ { "name": "from", "in": "query", "schema": { "type": "string" } }, { "name": "to", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_agenda_calendarResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "agenda_calendar", "data": { "error": false, "from": "2026-06-19", "to": "2026-06-18" }, "events": [ { "text": "
" }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_broker_researchResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "news_broker_research", "slug": "APPLE-INC", "codezb": "4849", "links": [ { "href": "/news/indexes/", "text": "Indices News" }, { "href": "/news/currencies/", "text": "Currencies News" }, { "href": "/news/cryptocurrencies/", "text": "News" } ], "meta": { "link_count": 64, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns broker research with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/broker-research?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:34:59.116Z" } }, "/v1/calendar-finance": { "get": { "operationId": "msfin_get_calendar_finance", "summary": "Financial calendar", "tags": [ "Calendars" ], "parameters": [ { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_calendar_financeResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "calendar_finance", "tables": [ { "row_count": 57, "rows": [ { "col_0": "Add to a list Add to a list 0 selected To use this feature you must be a member Log in Sign up", "col_1": "Event", "col_2": "Time", "col_3": "Change", "col_4": "Capi.$" }, { "col_0": "Monday - June 08, 2026" }, { "col_0": "", "col_1": "THE CAMPBELL'S COMPANY", "col_2": "Earnings release", "col_3": "Q3 2026", "col_4": "07:15 am", "col_5": "+0.60%", "col_6": "6.46B" } ] } ], "meta": { "table_count": 1, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns financial calendar with source-native dates, event fields, and pagination where available.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/calendar-finance", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:34:59.766Z" } }, "/v1/company-governance": { "get": { "operationId": "msfin_get_company_governance", "summary": "Governance", "tags": [ "Company" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_company_governanceResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "company_governance", "slug": "APPLE-INC", "codezb": "4849", "tables": [ { "row_count": 2, "rows": [ { "col_0": "Market Closed - Nasdaq Other stock markets 04:00:00 2026-06-05 pm EDT", "col_1": "5-day change", "col_2": "1st Jan Change" }, { "col_0": "307.34 USD", "col_1": "-1.25%", "col_2": "", "col_3": "-1.51%", "col_4": "+13.05%" } ] }, { "row_count": 2, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 05", "col_1": "Apple to Unveil New AI Push at WWDC", "col_2": "MT" } ] }, { "row_count": 2, "rows": [ { "col_0": "General Counsel", "col_1": "-" }, { "col_0": "Corporate Secretary", "col_1": "-" } ] } ], "meta": { "table_count": 20, "tables_filtered_out": 98, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns governance with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/company-governance?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:00.398Z" } }, "/v1/company-shareholders": { "get": { "operationId": "msfin_get_company_shareholders", "summary": "Shareholders", "tags": [ "Company" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_company_shareholdersResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "company_shareholders", "slug": "APPLE-INC", "codezb": "4849", "tables": [ { "row_count": 2, "rows": [ { "col_0": "Market Closed - Nasdaq Other stock markets 04:00:00 2026-06-05 pm EDT", "col_1": "5-day change", "col_2": "1st Jan Change" }, { "col_0": "307.34 USD", "col_1": "-1.25%", "col_2": "", "col_3": "-1.51%", "col_4": "+13.05%" } ] }, { "row_count": 2, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 05", "col_1": "Apple to Unveil New AI Push at WWDC", "col_2": "MT" } ] }, { "row_count": 25, "rows": [ { "Name": "Vanguard Capital Management LLC td:not(.c-none):not(:first-child)\" data-collapse-group=\"shareholders-table\" > 6.494 %", "Equities": "953,847,648", "_": "6.494 %", "Valuation": "259 B $" }, { "Name": "BlackRock Advisors LLC td:not(.c-none):not(:first-child)\" data-collapse-group=\"shareholders-table\" > 5.903 %", "Equities": "866,930,684", "_": "5.903 %", "Valuation": "235 B $" }, { "Name": "STATE STREET CORPORATION td:not(.c-none):not(:first-child)\" data-collapse-group=\"shareholders-table\" > 4.101 %", "Equities": "602,341,409", "_": "4.101 %", "Valuation": "163 B $" } ] } ], "meta": { "table_count": 6, "tables_filtered_out": 1, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns shareholders with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/company-shareholders?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:01.000Z" } }, "/v1/consensus": { "get": { "operationId": "msfin_get_consensus", "summary": "Summary", "tags": [ "Consensus" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_consensusResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "consensus", "slug": "APPLE-INC", "codezb": "4849", "tables": [ { "row_count": 2, "rows": [ { "col_0": "Market Closed - Nasdaq Other stock markets 04:00:00 2026-06-05 pm EDT", "col_1": "5-day change", "col_2": "1st Jan Change" }, { "col_0": "307.34 USD", "col_1": "-1.25%", "col_2": "", "col_3": "-1.51%", "col_4": "+13.05%" } ] }, { "row_count": 2, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 05", "col_1": "Apple to Unveil New AI Push at WWDC", "col_2": "MT" } ] }, { "row_count": 25, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 04", "col_1": "APPLE INC : UBS reiterates its Neutral rating", "col_2": "ZD" }, { "col_0": "Jun. 03", "col_1": "Apple Developer Conference Unlikely to Be Positive Catalyst for Shares, UBS Says", "col_2": "MT" } ] } ], "meta": { "table_count": 5, "tables_filtered_out": 0, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns summary with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/consensus?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:01.615Z" } }, "/v1/consensus-revisions": { "get": { "operationId": "msfin_get_consensus_revisions", "summary": "Revisions", "tags": [ "Consensus" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_consensus_revisionsResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "consensus_revisions", "slug": "APPLE-INC", "codezb": "4849", "tables": [ { "row_count": 2, "rows": [ { "col_0": "Market Closed - Nasdaq Other stock markets 04:00:00 2026-06-05 pm EDT", "col_1": "5-day change", "col_2": "1st Jan Change" }, { "col_0": "307.34 USD", "col_1": "-1.25%", "col_2": "", "col_3": "-1.51%", "col_4": "+13.05%" } ] }, { "row_count": 2, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 05", "col_1": "Apple to Unveil New AI Push at WWDC", "col_2": "MT" } ] }, { "row_count": 7, "rows": [ { "col_0": "", "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m": "APPLE INC.", "1m__Revenue_rev_": "", "1y__Revenue_rev_": "", "1y__EPS_revision": "" }, { "col_0": "", "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m": "XIAOMI CORPORATION", "1m__Revenue_rev_": "", "1y__Revenue_rev_": "", "1y__EPS_revision": "" }, { "col_0": "", "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m": "SHENZHEN TRANSSION HOLDINGS CO., LTD.", "1m__Revenue_rev_": "", "1y__Revenue_rev_": "", "1y__EPS_revision": "" } ] } ], "meta": { "table_count": 3, "tables_filtered_out": 0, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns revisions with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/consensus-revisions?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:02.189Z" } }, "/v1/finances-balance": { "get": { "operationId": "msfin_get_finances_balance", "summary": "Balance sheet", "tags": [ "Financials" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_finances_balanceResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "finances_balance", "slug": "APPLE-INC", "codezb": "4849", "series": [ { "name": "Revenues", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" }, { "name": "Total Revenues", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" }, { "name": "Cost of Goods Sold, Total", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" } ], "meta": { "series_count": 265, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns balance sheet with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/finances-balance?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:02.846Z" } }, "/v1/finances-cashflow": { "get": { "operationId": "msfin_get_finances_cashflow", "summary": "Cash flow", "tags": [ "Financials" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_finances_cashflowResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "finances_cashflow", "slug": "APPLE-INC", "codezb": "4849", "series": [ { "name": "Revenues", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" }, { "name": "Total Revenues", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" }, { "name": "Cost of Goods Sold, Total", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" } ], "meta": { "series_count": 265, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns cash flow with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/finances-cashflow?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:03.513Z" } }, "/v1/finances-income": { "get": { "operationId": "msfin_get_finances_income", "summary": "Income statement", "tags": [ "Financials" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_finances_incomeResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "finances_income", "slug": "APPLE-INC", "codezb": "4849", "tables": [ { "row_count": 2, "rows": [ { "col_0": "Market Closed - Nasdaq Other stock markets 04:00:00 2026-06-05 pm EDT", "col_1": "5-day change", "col_2": "1st Jan Change" }, { "col_0": "307.34 USD", "col_1": "-1.25%", "col_2": "", "col_3": "-1.51%", "col_4": "+13.05%" } ] }, { "row_count": 2, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 05", "col_1": "Apple to Unveil New AI Push at WWDC", "col_2": "MT" } ] }, { "row_count": 59, "rows": [ { "2016": "", "2017": "", "2018": "", "2019": "", "2020": "", "2021": "366B", "2022": "394B", "2023": "383B", "2024": "391B", "2025": "416B", "Fiscal_Period__September": "Revenues" }, { "2016": "", "2017": "", "2018": "", "2019": "", "2020": "", "2021": "366B", "2022": "394B", "2023": "383B", "2024": "391B", "2025": "416B", "Fiscal_Period__September": "Total Revenues" }, { "2016": "", "2017": "", "2018": "", "2019": "", "2020": "", "2021": "213B", "2022": "224B", "2023": "214B", "2024": "210B", "2025": "221B", "Fiscal_Period__September": "Cost of Goods Sold, Total" } ] } ], "meta": { "table_count": 6, "tables_filtered_out": 0, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns income statement with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/finances-income?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:04.188Z" } }, "/v1/finances-ratios": { "get": { "operationId": "msfin_get_finances_ratios", "summary": "Ratios", "tags": [ "Financials" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_finances_ratiosResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "finances_ratios", "slug": "APPLE-INC", "codezb": "4849", "series": [ { "name": "Revenues", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" }, { "name": "Total Revenues", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" }, { "name": "Cost of Goods Sold, Total", "categories": [ 2016, 2017, 2018 ], "data": [ null, null, null ], "data_type": "column" } ], "meta": { "series_count": 265, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns ratios with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/finances-ratios?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:04.995Z" } }, "/v1/news-insiders": { "get": { "operationId": "msfin_get_news_insiders", "summary": "Insiders", "tags": [ "News" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_news_insidersResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "news_insiders", "slug": "APPLE-INC", "codezb": "4849", "links": [ { "href": "/news/indexes/", "text": "Indices News" }, { "href": "/news/currencies/", "text": "Currencies News" }, { "href": "/news/cryptocurrencies/", "text": "News" } ], "meta": { "link_count": 64, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns insiders with headline, timestamp, symbol, and source fields where available.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/news-insiders?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:05.657Z" } }, "/v1/ratings": { "get": { "operationId": "msfin_get_ratings", "summary": "Ratings", "tags": [ "Research" ], "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_ratingsResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "ratings", "slug": "APPLE-INC", "codezb": "4849", "tables": [ { "row_count": 2, "rows": [ { "col_0": "Market Closed - Nasdaq Other stock markets 04:00:00 2026-06-05 pm EDT", "col_1": "5-day change", "col_2": "1st Jan Change" }, { "col_0": "307.34 USD", "col_1": "-1.25%", "col_2": "", "col_3": "-1.51%", "col_4": "+13.05%" } ] }, { "row_count": 2, "rows": [ { "col_0": "Jun. 05", "col_1": "Apple Expected to Detail AI Push at Developer Conference, Wedbush Says", "col_2": "MT" }, { "col_0": "Jun. 05", "col_1": "Apple to Unveil New AI Push at WWDC", "col_2": "MT" } ] }, { "row_count": 17, "rows": [ { "col_0": "Fundamentals", "col_1": "Fundamentals This composite rating is the result of an average of the rankings according to the Growth (Composite), Returns (Composite), Profitability (Composite), Financial Health (Composite) and CAPEX/EBITDA ratings. The company must be covered by at least four of these five ratings for the calculation to be carried...", "Apple_Inc_": "", "Sector": "", "United_States": "" }, { "col_0": "Growth", "col_1": "Growth This composite rating is the result of an average of the rankings according to the Revenue growth, EPS growth and FCF growth ratings. If the company is covered by at least two of these three ratings, the calculation is performed. We recommend that you read the associated descriptions carefully.", "Apple_Inc_": "", "Sector": "", "United_States": "" }, { "col_0": "Revenue growth", "col_1": "Revenue growth This rating is based on the strength, consistency and improvement of the company's revenue growth over a 6-year window (5 growth rates), taking into account both the last 3 completed financial years and the outlook for the next 3 years. The greater the sales growth is in terms of significance, consi...", "Apple_Inc_": "", "Sector": "", "United_States": "" } ] } ], "meta": { "table_count": 12, "tables_filtered_out": 0, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns ratings with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/ratings?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:06.440Z" } }, "/v1/right-sidebar": { "get": { "operationId": "msfin_get_right_sidebar", "summary": "Market sidebar", "parameters": [ { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_right_sidebarResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "right_sidebar", "blocks": [ { "text": " Indices " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_searchResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "search", "query": "AAPL", "matches": [ { "slug": "APPLE-INC", "codezb": "4849", "label": "APPLE INC. USD" } ] } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Searches MarketScreener data and returns source-native matches and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/search?q=AAPL", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:07.706Z" } }, "/v1/sector-heatmap": { "get": { "operationId": "msfin_get_sector_heatmap", "summary": "Sector heatmap", "parameters": [ { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_sector_heatmapResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "sector_heatmap", "data": { "error": false, "data": [ { "id": "5700000000", "name": "Technology", "custom": { "fullName": "Technology", "link": "/stock-exchange/sectors/technology/?cf=c2VaM0Nob24rQjZTWVBqdmlRbUtLUnM1RXA1WEFwTUtkOXR0T01RVXlQMnJ4WEw2TDBYZGFBQU83dnFXU0VpYQ", "performance": -4.618744710224251 }, "colorValue": -4.618744710224251, "value": 32168282725991 }, { "id": "5300000000", "name": "Consumer Cyclicals", "custom": { "fullName": "Consumer Cyclicals", "link": "/stock-exchange/sectors/consumer-cyclicals/?cf=c2VaM0Nob24rQjZTWVBqdmlRbUtLUnM1RXA1WEFwTUtkOXR0T01RVXlQMFJrV2xhNEIvN2N4V1o2MktTVEt1eA", "performance": -2.331278756913324 }, "colorValue": -2.331278756913324, "value": 7358749279469 }, { "id": "5600000000", "name": "Healthcare", "custom": { "fullName": "Healthcare", "link": "/stock-exchange/sectors/healthcare/?cf=c2VaM0Nob24rQjZTWVBqdmlRbUtLUnM1RXA1WEFwTUtkOXR0T01RVXlQMXJFd0dTU09FRDRFOHgvaVFZQzRlZQ", "performance": 0.6978336202828614 }, "colorValue": 0.6978336202828614, "value": 5666301847061 } ] }, "codezb": "4985", "meta": { "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns sector heatmap with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/sector-heatmap?codezb=4985", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:08.145Z" } }, "/v1/segment-revenue": { "get": { "operationId": "msfin_get_segment_revenue", "summary": "Segment revenue", "tags": [ "Financials" ], "parameters": [ { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_segment_revenueResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "segment_revenue", "data": { "error": false, "data": [ { "name": "Americas", "y": 178353000000 }, { "name": "Europe", "y": 111032000000 }, { "name": "Greater China", "y": 64377000000 } ], "message": null }, "codezb": "4849", "meta": { "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns segment revenue with source-native fields and identifiers.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/segment-revenue?codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:08.750Z" } }, "/v1/transcripts": { "get": { "operationId": "msfin_get_transcripts", "summary": "Call transcripts", "parameters": [ { "name": "slug", "in": "query", "schema": { "type": "string" } }, { "name": "codezb", "in": "query", "schema": { "type": "string" } }, { "name": "x-msfin-contact", "in": "header", "required": false, "schema": { "type": "string", "format": "email" }, "description": "Optional contact email for higher public rate limits and support diagnostics." }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "example": "Bearer " }, "description": "Optional API-key authorization for higher-volume access tiers." } ], "security": [ {}, { "ContactEmail": [] }, { "BearerAuth": [] }, { "MsfinApiKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/msfin_get_transcriptsResponse" }, "examples": { "live": { "summary": "Live response", "value": { "contract": "news_call_transcripts", "slug": "APPLE-INC", "codezb": "4849", "links": [ { "href": "/news/companies/call-transcripts/", "text": "Transcripts" }, { "href": "/quote/stock/APPLE-INC-4849/news-call-transcripts/", "text": "Transcripts" }, { "href": "/news/transcript-apple-inc-q2-2026-earnings-call-apr-30-2026-ce7f58d8de80ff2c", "text": "Apple Inc., Q2 2026 Earnings Call, Apr 30, 2026" } ], "meta": { "link_count": 27, "status": "ok" } } } } } } }, "400": { "description": "Bad request. A required parameter is missing, malformed, or outside the supported range.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 400 error", "value": { "ok": false, "error": { "code": "bad_request", "message": "Required query parameter is missing or invalid." } } } } } } }, "401": { "description": "Unauthorized. API-key authenticated tiers use an Authorization bearer token.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 401 error", "value": { "ok": false, "error": { "code": "unauthorized", "message": "A valid API key is required for this tier." } } } } } } }, "404": { "description": "Not found. The requested route, resource, or symbol could not be resolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 404 error", "value": { "ok": false, "error": { "code": "not_found", "message": "The requested resource was not found." } } } } } } }, "405": { "description": "Method not allowed. Source API routes are documented as HTTP GET unless otherwise specified.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 405 error", "value": { "ok": false, "error": { "code": "method_not_allowed", "message": "This route does not support the requested HTTP method." } } } } } } }, "429": { "description": "Rate limited. Retry after the limit reset or include the documented contact/API-key headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 429 error", "value": { "ok": false, "error": { "code": "rate_limited", "message": "Too many requests. Retry after the rate-limit reset." } } } } } } }, "502": { "description": "Upstream source error. The source service rejected or failed the upstream request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 502 error", "value": { "ok": false, "error": { "code": "upstream_error", "message": "The upstream source returned an error." } } } } } } }, "503": { "description": "Service unavailable. The source API or an upstream dependency is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 503 error", "value": { "ok": false, "error": { "code": "service_unavailable", "message": "The service is temporarily unavailable." } } } } } } }, "504": { "description": "Upstream timeout. The upstream source did not return within the source API timeout window.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "default": { "summary": "HTTP 504 error", "value": { "ok": false, "error": { "code": "upstream_timeout", "message": "The upstream source timed out." } } } } } } } }, "description": "Returns call transcripts with transcript, speaker, segment, and company fields where available.", "x-source-api": "msfin", "x-source-name": "MarketScreener", "x-source-upstream": "marketscreener.com", "x-docs-example-url": "https://api.msfin.bluedoor.sh/v1/transcripts?slug=APPLE-INC&codezb=4849", "x-docs-example-status": 200, "x-docs-captured-at": "2026-06-07T01:35:09.473Z" } } }, "components": { "securitySchemes": { "ContactEmail": { "type": "apiKey", "in": "header", "name": "X-Msfin-Contact" }, "BearerAuth": { "type": "http", "scheme": "bearer", "description": "API keys are available by emailing sam@bluedoor.sh." }, "MsfinApiKey": { "type": "apiKey", "in": "header", "name": "X-Msfin-Key" } }, "schemas": { "ErrorEnvelope": { "type": "object", "additionalProperties": true, "properties": { "ok": { "type": "boolean", "example": false }, "error": { "type": "object", "additionalProperties": true, "properties": { "code": { "type": "string" }, "message": { "type": "string" } } }, "meta": { "type": "object", "additionalProperties": true } } }, "msfin_get_agenda_calendarResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "data": { "type": "object", "additionalProperties": true, "properties": { "error": { "type": "boolean" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "error", "from", "to" ] }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "text": { "type": "string" } }, "required": [ "text" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "status": { "type": "string" } }, "required": [ "status" ] } }, "required": [ "contract", "data", "events", "meta" ] }, "msfin_get_broker_researchResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "links": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "href": { "type": "string" }, "text": { "type": "string" } }, "required": [ "href", "text" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "link_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "link_count", "status" ] } }, "required": [ "codezb", "contract", "links", "meta", "slug" ] }, "msfin_get_calendar_financeResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "col_5": { "type": "string" }, "col_6": { "type": "string" } }, "required": [ "col_0", "col_1", "col_2", "col_3", "col_4", "col_5", "col_6" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count" ] } }, "required": [ "contract", "meta", "tables" ] }, "msfin_get_company_governanceResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "Director": { "type": "string" }, "Committees_Since": { "type": "string" }, "Insider": { "type": "string" }, "Positions_held_Since_Until": { "type": "string" } }, "required": [ "Committees_Since", "Director", "Insider", "Positions_held_Since_Until", "col_0", "col_1", "col_2", "col_3", "col_4" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "tables_filtered_out": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count", "tables_filtered_out" ] } }, "required": [ "codezb", "contract", "meta", "slug", "tables" ] }, "msfin_get_company_shareholdersResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "Name": { "type": "string" }, "Equities": { "type": "string" }, "_": { "type": "string" }, "Valuation": { "type": "string" } }, "required": [ "Equities", "Name", "Valuation", "_", "col_0", "col_1", "col_2", "col_3", "col_4" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "tables_filtered_out": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count", "tables_filtered_out" ] } }, "required": [ "codezb", "contract", "meta", "slug", "tables" ] }, "msfin_get_consensusResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m": { "type": "string" }, "Consensus": { "type": "string" }, "Analysts__039__recommendations_evolution__4_months_": { "type": "string" }, "Financial_estimates_divergence": { "type": "string" }, "Analysts__039__Target_price_divergence": { "type": "string" }, "Objective_dr_gap": { "type": "string" } }, "required": [ "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m", "Analysts__039__Target_price_divergence", "Analysts__039__recommendations_evolution__4_months_", "Consensus", "Financial_estimates_divergence", "Objective_dr_gap", "col_0", "col_1", "col_2", "col_3", "col_4" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "tables_filtered_out": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count", "tables_filtered_out" ] } }, "required": [ "codezb", "contract", "meta", "slug", "tables" ] }, "msfin_get_consensus_revisionsResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m": { "type": "string" }, "1m__Revenue_rev_": { "type": "string" }, "1y__Revenue_rev_": { "type": "string" }, "1y__EPS_revision": { "type": "string" } }, "required": [ "1m__Revenue_rev_", "1y__EPS_revision", "1y__Revenue_rev_", "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m", "col_0", "col_1", "col_2", "col_3", "col_4" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "tables_filtered_out": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count", "tables_filtered_out" ] } }, "required": [ "codezb", "contract", "meta", "slug", "tables" ] }, "msfin_get_finances_balanceResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "series": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "categories": { "type": "array", "items": { "type": "integer" } }, "data": { "type": "array", "items": { "oneOf": [ { "nullable": true }, { "type": "integer" }, { "type": "number" } ] } }, "data_type": { "type": "string" } }, "required": [ "categories", "data", "data_type", "name" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "series_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "series_count", "status" ] } }, "required": [ "codezb", "contract", "meta", "series", "slug" ] }, "msfin_get_finances_cashflowResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "series": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "categories": { "type": "array", "items": { "type": "integer" } }, "data": { "type": "array", "items": { "oneOf": [ { "nullable": true }, { "type": "integer" }, { "type": "number" } ] } }, "data_type": { "type": "string" } }, "required": [ "categories", "data", "data_type", "name" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "series_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "series_count", "status" ] } }, "required": [ "codezb", "contract", "meta", "series", "slug" ] }, "msfin_get_finances_incomeResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "2016": { "type": "string" }, "2017": { "type": "string" }, "2018": { "type": "string" }, "2019": { "type": "string" }, "2020": { "type": "string" }, "2021": { "type": "string" }, "2022": { "type": "string" }, "2023": { "type": "string" }, "2024": { "type": "string" }, "2025": { "type": "string" }, "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "Fiscal_Period__September": { "type": "string" } }, "required": [ "2016", "2017", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025", "Fiscal_Period__September", "col_0", "col_1", "col_2", "col_3", "col_4" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "tables_filtered_out": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count", "tables_filtered_out" ] } }, "required": [ "codezb", "contract", "meta", "slug", "tables" ] }, "msfin_get_finances_ratiosResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "series": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "categories": { "type": "array", "items": { "type": "integer" } }, "data": { "type": "array", "items": { "oneOf": [ { "nullable": true }, { "type": "integer" }, { "type": "number" } ] } }, "data_type": { "type": "string" } }, "required": [ "categories", "data", "data_type", "name" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "series_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "series_count", "status" ] } }, "required": [ "codezb", "contract", "meta", "series", "slug" ] }, "msfin_get_news_insidersResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "links": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "href": { "type": "string" }, "text": { "type": "string" } }, "required": [ "href", "text" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "link_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "link_count", "status" ] } }, "required": [ "codezb", "contract", "links", "meta", "slug" ] }, "msfin_get_ratingsResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "tables": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "row_count": { "type": "integer" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "col_0": { "type": "string" }, "col_1": { "type": "string" }, "col_2": { "type": "string" }, "col_3": { "type": "string" }, "col_4": { "type": "string" }, "Apple_Inc_": { "type": "string" }, "Sector": { "type": "string" }, "United_States": { "type": "string" }, "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m": { "type": "string" }, "Capi____": { "type": "string" }, "Investor": { "type": "string" }, "ESG_MSCI": { "type": "string" }, "Fundamentals": { "type": "string" }, "Financial_revisions": { "type": "string" }, "Global_Valuation": { "type": "string" }, "Visibility": { "type": "string" }, "Consensus": { "type": "string" } }, "required": [ "Add_to_a_list_Add_to_a_list_0_selected_To_use_this_feature_you_m", "Apple_Inc_", "Capi____", "Consensus", "ESG_MSCI", "Financial_revisions", "Fundamentals", "Global_Valuation", "Investor", "Sector", "United_States", "Visibility", "col_0", "col_1", "col_2", "col_3", "col_4" ] } } }, "required": [ "row_count", "rows" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "table_count": { "type": "integer" }, "tables_filtered_out": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "status", "table_count", "tables_filtered_out" ] } }, "required": [ "codezb", "contract", "meta", "slug", "tables" ] }, "msfin_get_right_sidebarResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "blocks": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "text": { "type": "string" } }, "required": [ "text" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "block_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "block_count", "status" ] } }, "required": [ "blocks", "contract", "meta" ] }, "msfin_get_searchResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "query": { "type": "string" }, "matches": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "slug": { "type": "string" }, "codezb": { "type": "string" }, "label": { "type": "string" } }, "required": [ "codezb", "label", "slug" ] } } }, "required": [ "contract", "matches", "query" ] }, "msfin_get_sector_heatmapResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "data": { "type": "object", "additionalProperties": true, "properties": { "error": { "type": "boolean" }, "data": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "custom": { "type": "object", "additionalProperties": true, "properties": { "fullName": { "type": "string" }, "link": { "type": "string" }, "performance": { "type": "number" } }, "required": [ "fullName", "link", "performance" ] }, "colorValue": { "type": "number" }, "value": { "type": "integer" } }, "required": [ "colorValue", "custom", "id", "name", "value" ] } } }, "required": [ "data", "error" ] }, "codezb": { "type": "string" }, "meta": { "type": "object", "additionalProperties": true, "properties": { "status": { "type": "string" } }, "required": [ "status" ] } }, "required": [ "codezb", "contract", "data", "meta" ] }, "msfin_get_segment_revenueResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "data": { "type": "object", "additionalProperties": true, "properties": { "error": { "type": "boolean" }, "data": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "y": { "type": "integer" } }, "required": [ "name", "y" ] } }, "message": { "nullable": true } }, "required": [ "data", "error", "message" ] }, "codezb": { "type": "string" }, "meta": { "type": "object", "additionalProperties": true, "properties": { "status": { "type": "string" } }, "required": [ "status" ] } }, "required": [ "codezb", "contract", "data", "meta" ] }, "msfin_get_transcriptsResponse": { "type": "object", "additionalProperties": true, "properties": { "contract": { "type": "string" }, "slug": { "type": "string" }, "codezb": { "type": "string" }, "links": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "href": { "type": "string" }, "text": { "type": "string" } }, "required": [ "href", "text" ] } }, "meta": { "type": "object", "additionalProperties": true, "properties": { "link_count": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "link_count", "status" ] } }, "required": [ "codezb", "contract", "links", "meta", "slug" ] } } }, "x-generated-at": "2026-06-07T01:30:59.456Z", "x-source-api": "msfin", "x-source-base-url": "https://api.msfin.bluedoor.sh" }