# Server-to-Server (S2S) Calls

## Auction Endpoints

<table><thead><tr><th width="97">Region</th><th width="447">URL</th><th width="83">Method</th><th width="127">City</th><th>Data Center</th></tr></thead><tbody><tr><td>AMER</td><td><a href="https://mp-las.4dex.io/ortb"><code>https://mp-las.4dex.io/ortb/{PUBLISHER_ID}</code></a></td><td>POST</td><td>Las Vegas</td><td>GCP us-west4</td></tr><tr><td>EMEA</td><td><a href="https://mp-las.4dex.io/ortb"><code>https://mp-ams.4dex.io/ortb/{PUBLISHER_ID}</code></a></td><td>POST</td><td>Amsterdam</td><td>GCP europe-west4</td></tr><tr><td>APAC</td><td><a href="https://mp-las.4dex.io/ortb"><code>https://mp-tyo.4dex.io/ortb/{PUBLISHER_ID}</code></a></td><td>POST</td><td>Tokyo</td><td>GCP asia-northeast1</td></tr></tbody></table>

Your `PUBLISHER_ID` can be found under _Settings > General_ in the [Adagio Manager](https://app.adagio.io).

## S2S Headers

The OpenRTB Version should be passed in the header of a bid request with a custom HTTP header.

* `x-openrtb-version: 2.5`
* `x-openrtb-version: 2.6`

## OpenRTB field requirements

<table><thead><tr><th width="182">Path</th><th width="149">Mandatory</th><th width="89">Type</th><th width="310">Description</th></tr></thead><tbody><tr><td>site.publisher.id</td><td><mark style="color:red;">Yes</mark></td><td>string</td><td><strong>Your ID, provided by Adagio</strong>, found under <em>Settings > General</em> in the <a href="https://app.adagio.io">Adagio Manager</a>.</td></tr><tr><td>site.domain</td><td><mark style="color:red;">Yes</mark></td><td>string</td><td><strong>Domain of the site</strong>. e.g. “<a href="http://mysite.foo.com/">mysite.foo.com</a>”. </td></tr><tr><td>imp[].tagid</td><td><mark style="color:red;">Yes</mark></td><td>string</td><td><strong>Custom value you define</strong> to identify an ad unit placement. Use consistent values, avoiding auto-incremented or random values. <br>e.g."identifier12345".<br>- max length: 150<br>- max distinctive values: 100</td></tr><tr><td>user.buyeruid</td><td><mark style="color:orange;">Highly Recommended</mark></td><td>string</td><td><strong>Adagio User ID</strong>, <a href="https://adagio-io.gitbook.io/adagio-documentation/openrtb-endpoint/editor/supplier-user-matching#adagio-user-id">as described here</a>.</td></tr><tr><td>user.ext.eids <em>or</em><br>user.eids</td><td><mark style="color:orange;">Highly Recommended</mark></td><td>object</td><td><strong>User IDs</strong>. If you already have the User ID of bidders monetizing through the Adagio Demand Library, then it is recommended adding them to your Bid Request, <a href="https://adagio-io.gitbook.io/adagio-documentation/openrtb-endpoint/editor/supplier-user-matching#other-bidders-user-ids">as described here</a>.</td></tr><tr><td>tmax</td><td><mark style="color:orange;">Highly Recommended</mark></td><td>int</td><td><strong>Maximum time in milliseconds the exchange allows</strong> for bids to be received including Internet latency to avoid timeout.<br>Minimum value: <code>470</code>.</td></tr><tr><td>imp[].ext.gpid</td><td><mark style="color:purple;">Recommended</mark></td><td>string</td><td><strong>Global Placement ID.</strong> <a href="https://partner.thetradedesk.com/v3/portal/ssp/doc/GlobalPlacementID">Official documentation</a>.</td></tr><tr><td>site.ext.pagetype</td><td><mark style="color:purple;">Recommended</mark></td><td>string</td><td><strong>Describes what kind of content will be present in the page</strong>.<br>- max length: 30<br>- max distinctive values: 50</td></tr><tr><td>site.ext.category</td><td><mark style="color:purple;">Recommended</mark></td><td>string</td><td><strong>Category of the content displayed in the page</strong>.<br>- max length: 30<br>- max distinctive values: 50</td></tr></tbody></table>



## Data Compression (gzip)

{% hint style="warning" %}
Adagio <mark style="color:orange;">ONLY</mark> supports Compressed JSON (gzip) for bid requests and bid responses.
{% endhint %}

It is <mark style="color:orange;">**mandatory**</mark> to use Compressed JSON to reduce the amount of data exchanged between you and Adagio, as this decreases server communication latencies, and traffic listening costs for all parties involved.

Configure compressed JSON bid requests and enable compressed responses:

{% stepper %}
{% step %}
Compress your HTTP request body with `gzip`
{% endstep %}

{% step %}
Add a <mark style="color:blue;">**`Content-Encoding: gzip`**</mark> HTTP header to indicate that the request is compressed
{% endstep %}

{% step %}
Add an <mark style="color:blue;">**`Accept-Encoding: gzip`**</mark> header to indicate that you can accept a compressed response
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Bid responses include a <mark style="color:blue;">**`Content-Encoding: gzip`**</mark> HTTP header to indicate compression. To distinguish between JSON and Compressed JSON formats, check for this header. If present, **decompress the HTTP body before processing.**
{% endhint %}

## Supported Currencies

Adagio uses exchange rates from the European Central Bank to perform currency conversions. Below the list of currencies supported in Bid Requests and Bid Responses:

<details>

<summary>List of currencies supported in Bid Requests and Bid Responses</summary>

AUD\
BGN\
BRL\
CAD\
CHF\
CNY\
CZK\
DKK\
GBP\
HKD\
HUF\
IDR\
ILS\
INR\
ISK\
JPY\
KRW\
MXN\
MYR\
NOK\
NZD\
PHP\
PLN\
RON\
SEK\
SGD\
USD\
THB\
TRY\
ZAR

</details>





