# pair()

{% code title="CarbonController.sol" overflow="wrap" lineNumbers="true" %}

```solidity
    function pair(Token token0, Token token1) external view returns (Pair memory);
```

{% endcode %}

This function is used to get the metadata for the pair of the indicated tokens. This includes the ID of the pair, token0, and token1. 

### **Function Arguments**

<table><thead><tr><th width="175">Name</th><th width="142.66666666666663">Type</th><th>Description</th></tr></thead><tbody><tr><td>token0</td><td>Token</td><td>The first token address. </td></tr><tr><td>token1</td><td>Token</td><td>The second token address.</td></tr></tbody></table>

### Returns

This function returns a Pair object, containing the pair ID and the addresses of token0 and token1.

<table><thead><tr><th width="187">Name</th><th width="118.66666666666663">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>uint256</td><td>The ID of the pair </td></tr><tr><td>token0</td><td>Token</td><td>The first token address </td></tr><tr><td>token1</td><td>Token</td><td>The second token address</td></tr></tbody></table>

### Example

<pre><code>pair(
 0x514910771AF9Ca656af840dff83E8264EcF986CA, //token0
 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE //token1
)

// Returns:
// struct Pair {
//    uint128 id;
//    Token[2] tokens;
<strong>// }
</strong></code></pre>

{% hint style="info" %}
For the ETH token, use the contract address: *0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE*&#x20;
{% endhint %}