# motif Docs

## Documentation

- [Introduction](https://motif.gitbook.io/motif-docs/getting-started/readme.md): What Motif is, the surfaces you'll use, and how the pieces fit together.
- [Quickstart](https://motif.gitbook.io/motif-docs/getting-started/quickstart.md): Create an organization and API key, install the SDK, and make your first call.
- [Authentication](https://motif.gitbook.io/motif-docs/getting-started/authentication.md): API keys, request headers, environments, rate limits, and error codes.
- [Overview](https://motif.gitbook.io/motif-docs/products/products.md): What you can sell on top of Motif: insights, profiling, proposals, and monitoring.
- [Market insights](https://motif.gitbook.io/motif-docs/products/market-insights.md): A top-down read of what's moving markets, grounded in evidence.
- [Asset insights](https://motif.gitbook.io/motif-docs/products/asset-insights.md): A close read on one company or token, with fundamentals anchored to the narrative.
- [Portfolio insights](https://motif.gitbook.io/motif-docs/products/portfolio-insights.md): What's moving a specific portfolio, position by position.
- [Profiling](https://motif.gitbook.io/motif-docs/products/profiling.md): Build a structured, explainable investor profile from questions and conversation.
- [Investment proposals](https://motif.gitbook.io/motif-docs/products/investment-proposals.md): Generate explainable, profile-aligned investment strategies.
- [Market signals & monitoring](https://motif.gitbook.io/motif-docs/products/signals.md): A continuous watch on markets and portfolios, delivered as alerts and digests.
- [Overview](https://motif.gitbook.io/motif-docs/clarity/clarity.md): Motif's financial research engine. What it is and how it works.
- [Pipeline](https://motif.gitbook.io/motif-docs/clarity/pipeline.md): How Clarity turns source material into grounded financial answers.
- [Surfaces & analyst personas](https://motif.gitbook.io/motif-docs/clarity/surfaces.md): One Clarity analyst answers every surface. What changes is the persona, the answer shape, and what it can see.
- [Personalization](https://motif.gitbook.io/motif-docs/clarity/personalization.md): How Clarity learns a member's positioning — a book of conviction theses, kept current by a feedback loop — and uses it to personalize every answer.
- [Cost](https://motif.gitbook.io/motif-docs/clarity/cost.md): What it costs to run Clarity, both to ingest articles and to answer questions.
- [In the admin panel](https://motif.gitbook.io/motif-docs/clarity/admin.md): Ingest sources, inspect what was extracted, explore the graph, and ask questions.
- [Integrate Clarity](https://motif.gitbook.io/motif-docs/clarity/integrate.md): Call the Clarity card and chat from your backend, over the SDK or REST.
- [Portfolio context](https://motif.gitbook.io/motif-docs/clarity/portfolio-context.md): The holdings, trades, and profile model every Clarity call runs against.
- [Embed Clarity](https://motif.gitbook.io/motif-docs/clarity/embed.md): Render Clarity in a browser without exposing your API key.
- [Overview](https://motif.gitbook.io/motif-docs/clarity-in-depth/concepts.md): The vocabulary and the core ideas behind Clarity: what it knows and how it keeps knowing it.
- [Ingestion](https://motif.gitbook.io/motif-docs/clarity-in-depth/ingestion.md): How source material gets into Clarity. The feeds, the staging, and the screening that keeps noise out.
- [Extraction](https://motif.gitbook.io/motif-docs/clarity-in-depth/extraction.md): How Clarity turns one document into structured entities, facts, and relationships.
- [Memory](https://motif.gitbook.io/motif-docs/clarity-in-depth/memory.md): What Clarity keeps and answers from. A curated, durable graph, kept separate from raw reading and from answers.
- [Asset linking](https://motif.gitbook.io/motif-docs/clarity-in-depth/asset-linking.md): How Clarity connects an entity to the equity or token you can trade.
- [Dreaming](https://motif.gitbook.io/motif-docs/clarity-in-depth/dreaming.md): The background self-curation that keeps Clarity's memory concise, connected, and current over time.
- [Evaluation](https://motif.gitbook.io/motif-docs/clarity-in-depth/evaluation.md): How Clarity's answer quality is measured. It covers the fixed inputs it is tested on and the layered scoring that grades every answer.
- [Overview](https://motif.gitbook.io/motif-docs/client-portfolios/client-portfolios.md): Manage customer portfolios and the white-label portfolio app they're shown in.
- [Branding](https://motif.gitbook.io/motif-docs/client-portfolios/branding.md): Logo, colors, favicon, and support email for the portfolio app.
- [Custom domain](https://motif.gitbook.io/motif-docs/client-portfolios/custom-domain.md): Map your own host to the portfolio app.
- [Sender domain](https://motif.gitbook.io/motif-docs/client-portfolios/sender-domain.md): Send portfolio invitation and transactional emails from your own domain.
- [Overview](https://motif.gitbook.io/motif-docs/orders-and-trade-execution/orders.md): Turn approved investment strategies into on-chain orders, and monitor execution.
- [Overview](https://motif.gitbook.io/motif-docs/data-management/data-management.md): The asset universe (equities, tokens, products, funds) and the sources feeding Clarity.
- [Overview](https://motif.gitbook.io/motif-docs/observation-deck/observation-deck.md): Monitoring for your organization: audit logs, usage, system health, and AI cost.
- [Organization & team](https://motif.gitbook.io/motif-docs/settings/organization.md): Organization lifecycle, settings, team roles, and end users.
- [API keys](https://motif.gitbook.io/motif-docs/settings/api-keys.md): Create, manage, and rotate the keys that authenticate SDK and API calls.
- [AI providers](https://motif.gitbook.io/motif-docs/settings/ai-providers.md): Choose which AI models power each agent and task.
- [Webhooks](https://motif.gitbook.io/motif-docs/settings/webhooks.md): Receive signed events when things happen in Motif.
- [Overview](https://motif.gitbook.io/motif-docs/foresight-experimental/foresight.md): Forward-looking, multi-agent scenario analysis built on Clarity.
- [SDK](https://motif.gitbook.io/motif-docs/reference/sdk.md): The TypeScript SDK client surface.
- [API reference](https://motif.gitbook.io/motif-docs/reference/api-reference.md): REST endpoints for partner portfolios, Clarity, and embed tokens.
- [Error handling](https://motif.gitbook.io/motif-docs/reference/error-handling.md): The MotifSDKError shape, common failures, and handling patterns.

## API Reference

- [Developer Platform API](https://motif.gitbook.io/motif-docs/api-reference/readme.md)
- [Welcome to the GitBook Petstore API](https://motif.gitbook.io/motif-docs/api-reference/reference/welcome-to-the-gitbook-petstore-api.md)
- [Servers & Authentication](https://motif.gitbook.io/motif-docs/api-reference/reference/welcome-to-the-gitbook-petstore-api/servers-and-authentication.md)
- [Getting started](https://motif.gitbook.io/motif-docs/api-reference/reference/welcome-to-the-gitbook-petstore-api/getting-started.md)
- [Error responses](https://motif.gitbook.io/motif-docs/api-reference/reference/welcome-to-the-gitbook-petstore-api/error-responses.md)
- [Store](https://motif.gitbook.io/motif-docs/api-reference/reference/store.md)
- [Orders](https://motif.gitbook.io/motif-docs/api-reference/reference/store/orders.md): Place and manage customer orders.
- [Inventory](https://motif.gitbook.io/motif-docs/api-reference/reference/store/inventory.md): Track and update stock levels for pets in the store.
- [Pets](https://motif.gitbook.io/motif-docs/api-reference/reference/pets.md)
- [Animals](https://motif.gitbook.io/motif-docs/api-reference/reference/pets/animals.md): Browse and manage individual animals available for adoption.
- [Categories](https://motif.gitbook.io/motif-docs/api-reference/reference/pets/categories.md): Manage the species and breed categories used to classify pets.

## Changelog

- [Changelog](https://motif.gitbook.io/motif-docs/changelog/readme.md): New updates and improvements