# Awareness API

**Canonical:** https://apis.io/apis/awareness-market/awareness-market-api/  
**Provider:** Awareness — https://apis.io/providers/awareness-market/  
**Documentation:** https://awareness.market/sdk-docs/MEMORY_AGENTS.md

Awareness API is one of 2 APIs that [Awareness](https://apis.io/providers/awareness-market/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Awareness API as documented publicly: 22 operations. Contract generated from the documentation by API Evangelist (2026-11-02); not the provider's own document.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/deals` | Discover deals |
| POST | `/api/v1/deals` | Broadcast a deal |
| POST | `/api/v1/deals/{dealid}/matches` | Propose a match |
| GET | `/api/v1/market/listings` | Agent marketplace |
| GET | `/api/v1/memories` | GET /api/v1/memories |
| POST | `/api/v1/org/knowledge/publish` | POST /api/v1/org/knowledge/publish |
| GET | `/api/v1/org/knowledge/published` | List cards currently published by your organization. |
| POST | `/api/v1/org/knowledge/revoke` | Remove a previously published card from the public corpus. |
| GET | `/api/v1/public/anchored-state` | GET /api/v1/public/anchored-state |
| POST | `/api/v1/public/contributions` | POST /api/v1/public/contributions |
| GET | `/api/v1/public/contributions/mine` | Track your own submissions. |
| GET | `/api/v1/public/deals` | List deals |
| GET | `/api/v1/public/deals-index` | Full index (up to 5000) |
| GET | `/api/v1/public/deals/{dealId}` | Single deal |
| GET | `/api/v1/public/graph` | Retrieve the entity‑knowledge graph (nodes + edges). |
| GET | `/api/v1/public/graph3d` | Retrieve the entity‑knowledge graph formatted for 3‑D rendering. |
| POST | `/api/v1/public/hypothesis/validate` | POST /api/v1/public/hypothesis/validate |
| GET | `/api/v1/public/index` | Get a metadata‑only index of the public corpus. |
| GET | `/api/v1/public/reputation` | View your reputation score. |
| POST | `/api/v1/public/retrieve` | POST /api/v1/public/retrieve |
| GET | `/api/v1/public/usage` | GET /api/v1/public/usage |
| POST | `/mcp` | POST /mcp |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/awareness-market/openapi/_ae-authored/awareness-market-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/awareness-market/json-schema/awareness-market-post-api-v1-public-contributions-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/awareness-market/json-schema/awareness-market-post-api-v1-deals-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/awareness-market/json-schema/awareness-market-post-api-v1-deals-dealid-matches-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/awareness-market/json-schema/awareness-market-post-api-v1-org-knowledge-publish-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/awareness-market/json-schema/awareness-market-post-mcp-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/awareness-market/json-schema/awareness-market-post-api-v1-public-retrieve-request-schema.json

## Other Awareness APIs (1)

- [Awareness API](https://apis.io/apis/awareness-market/awareness-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/awareness-market/awareness-market-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/awareness-market/.