Resolve venue-native market ids to canonical catalog and cluster identities.
const url = 'https://data.predictefy.com/v1/mappings';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"pairs":[{"venue":"example","marketId":"example"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://data.predictefy.com/v1/mappings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "pairs": [ { "venue": "example", "marketId": "example" } ] }'DARK behind READS_ENABLE_MAPPINGS. Accepts 1 to 200 venue/marketId pairs and preserves their input order. Known markets return their canonical marketPk, current status, and clusterId when matched. Unknown and sandbox-venue pairs remain in the response with marketPk, clusterId, and status set to null.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
object
Venue id; the canonical market-pk separator : is not allowed.
Examplegenerated
{ "pairs": [ { "venue": "example", "marketId": "example" } ]}Responses
Section titled “Responses”One mapping result for every input pair, in input order.
object
object
Canonical {venue}:{marketId} identity, or null when unresolved.
Matched cluster identity, or null when unresolved or unmatched.
Current catalog market status, or null when unresolved.
Examplegenerated
{ "success": true, "data": [ { "venue": "example", "marketId": "example", "marketPk": "example", "clusterId": "example", "status": "example" } ]}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}