> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > ## Agent Instructions (AIsa) > > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # Get Company Facts > Get company facts for a ticker. Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** GET /apis/v1/financial/company/facts/ticker * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/financial/company/facts/ticker](https://api.aisa.one/apis/v1/financial/company/facts/ticker) * **cik:** query; optional * **ticker:** query; optional * **Runtime facts:** afe2e5d365275c032408a51b04030fb8f5be4f9d70a476d8735d89f06821a9b8 [Complete OpenAPI definition](https://aisa.one/docs/openapi/financial.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "any_financial_apis_v1_financial_company_facts_ticker", "method": "GET", "path": "/apis/v1/financial/company/facts/ticker", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "name": "cik", "in": "query", "description": "The CIK of the company.", "required": false, "schema": { "type": "string" } }, { "name": "ticker", "in": "query", "description": "The ticker symbol.", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.02 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.02 * **Cost contract:** fixed\_success * **Published reference multiplier:** 1.0 * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/financial.json GET /apis/v1/financial/company/facts/ticker openapi: 3.1.0 info: description: '' title: FinancialAPI version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/financial/analyst-estimates - /apis/v1/financial/company/facts - /apis/v1/financial/company/facts/ticker - /apis/v1/financial/crypto/prices - /apis/v1/financial/crypto/prices/snapshot - /apis/v1/financial/earnings - /apis/v1/financial/earnings/press-releases - /apis/v1/financial/filings - /apis/v1/financial/filings/items - /apis/v1/financial/financial-metrics - /apis/v1/financial/financial-metrics/snapshot - /apis/v1/financial/financials - /apis/v1/financial/financials/balance-sheets - /apis/v1/financial/financials/cash-flow-statements - /apis/v1/financial/financials/income-statements - /apis/v1/financial/financials/search/line-items - /apis/v1/financial/financials/search/screener - /apis/v1/financial/financials/segmented-revenues - /apis/v1/financial/insider-trades - /apis/v1/financial/institutional-ownership - /apis/v1/financial/kpi/guidance - /apis/v1/financial/kpi/metrics - /apis/v1/financial/kpi/non-gaap - /apis/v1/financial/macro/interest-rates - /apis/v1/financial/macro/interest-rates/snapshot - /apis/v1/financial/news - /apis/v1/financial/prices - /apis/v1/financial/prices/snapshot x-aisa-document: facts_hash: afe2e5d365275c032408a51b04030fb8f5be4f9d70a476d8735d89f06821a9b8 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '20' response_pending: - operation_id: get_financial_analyst_estimates path: /apis/v1/financial/analyst-estimates method: GET statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:61ad10f29d878952017d5fb9761fb6652a8e8d984742cb2895c9849a4b29ae4b x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: financial x-aisa-catalogs: financial: title: FinancialAPI description: '' x-aisa-document: facts_hash: afe2e5d365275c032408a51b04030fb8f5be4f9d70a476d8735d89f06821a9b8 generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/financial/company/facts/ticker: get: tags: - Zero summary: Get Company Facts description: >- Get company facts for a ticker. Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ. operationId: any_financial_apis_v1_financial_company_facts_ticker parameters: - name: cik in: query description: The CIK of the company. required: false schema: type: string - name: ticker in: query description: The ticker symbol. required: false schema: type: string responses: '200': description: Company facts response content: application/json: schema: $ref: '#/components/schemas/Response0081E61F2639_CompanyFactsResponse' default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response0081E61F2639_CompanyFactsResponse: type: object properties: company_facts: $ref: '#/components/schemas/Response0081E61F2639_CompanyFacts' Response0081E61F2639_CompanyFacts: type: object properties: ticker: type: string description: The ticker symbol of the company. name: type: string description: The name of the company. cik: type: string description: The Central Index Key (CIK) of the company. industry: type: string description: The industry of the company. sector: type: string description: The sector of the company. exchange: type: string description: The exchange of the company. is_active: type: boolean description: Whether the company is currently active. location: type: string description: The location of the company. sec_filings_url: type: string format: uri description: The URL of the company's SEC filings. sic_code: type: string description: The Standard Industrial Classification (SIC) code of the company. sic_industry: type: string description: The industry of the company based on the SIC code. sic_sector: type: string description: The sector of the company based on the SIC code. securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.