Aggregator Integration

Purpose

This contract is for odds-comparison products, prediction-market directories, trading terminals, data vendors, and smart routers that want to discover and link to Norynta markets without adapting Norynta's internal event model.

Fetch Markets

curl -sS \
  "https://norynta.com/api/v1/aggregator/markets?source=your-product&limit=100" \
  | jq

The endpoint is public, cursor-paginated, and short-cacheable. It defaults to strictly first-trade-ready markets. Use tradableOnly=0 when indexing all public live contracts, including markets that are still activating liquidity.

Supported filters:

• source: stable partner slug used for trade-link attribution
• category, q, status, sort: discovery filters
• cursor, limit: pagination
• includeResolved=1: include resolved markets when supported by the feed
• tradableOnly=0: include live contracts without a ready two-sided book

Stable Fields

Each market includes:

• venue and canonical on-chain market ID
• slug, title, category, market type, and lifecycle status
• close time and normalized outcomes
• display probability plus executable bid/ask when available
• total reported volume and executable depth
• rule text and the Norynta resolution endpoint
• a deterministic matching key and allowlisted external identifiers
• direct market, attributed trade, orderbook, trade-history, and image URLs

Only prices explicitly associated with the readiness outcome are labeled as executable bid/ask prices. Other outcomes retain their display price and probability but use null executable prices until the feed can prove them.

Attribution

Use the supplied urls.trade unchanged. It includes:

utm_source=<source>
utm_medium=aggregator
utm_campaign=market_distribution
utm_content=<market-slug>

Do not add wallet addresses, account IDs, search queries, or other personal data to attribution parameters.

Matching And Settlement Safety

matching.key is a discovery hint, not proof that two venue contracts settle identically. Before presenting arbitrage or routing claims, compare:

1. resolution source
2. observation and cutoff time
3. cancellation and revision policy
4. outcome definitions and edge-case rules

Use rules.resolutionUrl and the full market page as the source of truth.

SDK

The MIT-licensed @norynta/bot-sdk exports a typed helper:

import { fetchAggregatorMarkets } from "@norynta/bot-sdk/aggregator";

const feed = await fetchAggregatorMarkets({
  baseUrl: "https://norynta.com",
  source: "your-product",
  limit: 100,
});

Schema changes are versioned through the response schemaVersion and X-Api-Schema header. Integrators should ignore unknown additive fields.