Developer GuideQuick StartsFirst Bid in 5 min

First Bid in 5 Minutes

Register your bidder endpoint and receive your first bid request.


Create a demand source account

Go to exchange.praevis.com → Demand → Add Demand Source.

Fill in:

  • Name — your demand source or trading desk name
  • Integration type — Traditional RTB
  • Endpoint URL — your bidder URL (must be HTTPS, respond in < 150ms)
  • Daily budget — start with $10 for testing

Click Save. Note your Demand Source ID.

Receive a test bid request

Praevis sends a test bid request to your endpoint immediately after registration. Your endpoint will receive:

{
  "id": "test-abc123",
  "imp": [{
    "id": "1",
    "video": {
      "mimes": ["video/mp4"],
      "minduration": 6,
      "maxduration": 30,
      "protocols": [2, 3],
      "w": 1920, "h": 1080
    },
    "bidfloor": 0.50,
    "bidfloorcur": "USD"
  }],
  "app": {
    "bundle": "com.example.app",
    "content": { "genre": "drama" }
  },
  "device": { "devicetype": 3, "ip": "1.2.3.4" },
  "ext": { "partner_id": "...", "pool_id": "..." }
}

Return a valid bid response

Your endpoint must respond within 150ms with HTTP 200:

{
  "id": "test-abc123",
  "seatbid": [{
    "bid": [{
      "id": "my-bid-001",
      "impid": "1",
      "price": 2.50,
      "adm": "https://your-cdn.com/creative.xml",
      "crid": "creative-001",
      "w": 1920,
      "h": 1080
    }]
  }],
  "cur": "USD"
}

Respond with HTTP 204 (empty body) to pass — never return an error.

⚠️

Bid price must exceed the bidfloor in the request. A bid of 0 or below floor is ignored.

Check your win rate

Go to Demand → your demand source → Performance. You should see bid requests and wins within 60 seconds of your first live auction.


What’s next?