post/v1/matching/candidates
Bulk candidate ranking for a single listing — scores the network's candidate pool (subject to the same PRIVATE/GLOBAL/BOTH visibility boundary directory-service enforces) against the source listing and returns the top N by Trade Compatibility Score. See docs/architecture/matching-algorithm-spec.md.
Request body
| Field | Type | Required |
|---|
| listingId | string (uuid) | yes |
| limit | integer | — |
Response (201)
| Field | Type | Required |
|---|
| listingId | string (uuid) | — |
| candidates | object[] | — |
post/v1/matching/score
Direct pairwise Trade Compatibility Score for two known listings — used to preview compatibility before sending an offer
Request body
| Field | Type | Required |
|---|
| listingIdA | string (uuid) | yes |
| listingIdB | string (uuid) | yes |
Response (201)
| Field | Type | Required |
|---|
| score | number | — |
| breakdown | CompatibilityBreakdown | — |