API Documentation

Integrate with Adtryx using the OpenRTB 2.5 protocol for real-time bidding.

Overview

Adtryx uses the OpenRTB (Real-Time Bidding) 2.5 protocol specification for programmatic advertising. This protocol enables real-time auctions for ad impressions, allowing advertisers to bid on inventory in milliseconds.

Our RTB system processes bid requests and responses in JSON format over HTTP/HTTPS, ensuring fast and secure transactions for all parties involved.

Key Features

Low Latency

Response time under 100ms for optimal auction performance

Secure

HTTPS encryption and authentication for all API calls

Real-Time

Instant bid processing with real-time reporting

Global Scale

Distributed infrastructure across multiple regions

API Endpoint

Bid Request Endpoint:

POST https://rtb.adtryx.com/bid

Content-Type: application/json

Bid Request Structure

Standard OpenRTB 2.5 bid request format:

{
  "id": "unique-request-id",
  "imp": [{
    "id": "1",
    "banner": {
      "w": 300,
      "h": 250,
      "pos": 1
    },
    "bidfloor": 0.01,
    "bidfloorcur": "USD"
  }],
  "site": {
    "id": "site-id",
    "domain": "example.com",
    "cat": ["IAB1"],
    "page": "https://example.com/page"
  },
  "device": {
    "ua": "Mozilla/5.0...",
    "ip": "192.168.1.1",
    "geo": {
      "country": "USA",
      "region": "CA",
      "city": "Los Angeles"
    }
  },
  "user": {
    "id": "user-id"
  },
  "tmax": 100
}

Bid Response Structure

Standard OpenRTB 2.5 bid response format:

{
  "id": "unique-request-id",
  "seatbid": [{
    "bid": [{
      "id": "bid-id",
      "impid": "1",
      "price": 0.50,
      "adm": "<creative markup>",
      "adomain": ["advertiser.com"],
      "crid": "creative-id",
      "w": 300,
      "h": 250
    }],
    "seat": "seat-id"
  }],
  "cur": "USD"
}

Supported Objects

  • BidRequest - Top-level request object containing impression, site/app, device, and user data
  • Imp - Impression object describing the ad placement
  • Banner - Banner ad format specifications
  • Native - Native ad format specifications
  • Site/App - Publisher site or application details
  • Device - User device information including geo data
  • User - User identification and segment data
  • Geo - Geographic location information

Need Integration Help?

Contact our technical team for API credentials and integration support.