> For the complete documentation index, see [llms.txt](https://docs.tokensfarm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tokensfarm.com/for-developers/integrate-tokensfarm/get-farm-address-and-full-details.md).

# Get Farm Address and Full Details

### Get a List of Specific Farms with their Full Details

A farm's address will be included in the full farm details. In order to participate in a farm, you must first get the "full details" object, which will contain the farm's address. The address will allow you to interact with the contract.

{% hint style="info" %}
In the response, you will find the farm address under the field "TokensFarm"
{% endhint %}

## Filter by the token symbol to get full details for all corresponding farms

<mark style="color:blue;">`GET`</mark> `https://api.tokensfarm.com/farm/list?token=<token_symbol>&full=true`

will response object with full details on the farm.\
"TokensFarm" parameter on response will contain the address of the farm

#### Path Parameters

| Name       | Type    | Description                                                                                                |
| ---------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| active     | boolean | get only active/ended farms                                                                                |
| sort       | String  | <p>sort=apy -order by apy</p><p>sort=newest - order by date</p><p>sort=days\_left - order by days left</p> |
| page       | Integer | get data by page number                                                                                    |
| farm\_type | String  | <p>farm\_type=LP,STAKING<br>will return all the lp and staking farms</p><p></p>                            |
| token      | String  | <p>the symbol of the specific token<br>for example: token=PORTX</p>                                        |
| page\_size | Integer | the amount of farm objects in a page                                                                       |
| full       | boolean | if "true" will return a larger farm object with more data                                                  |
| view       | String  | example: tile                                                                                              |

{% tabs %}
{% tab title="200: OK Farm full info successfully fetched" %}
response example: <https://api.tokensfarm.com/farm/list?token=DCD&full=true>
{% endtab %}
{% endtabs %}

### Get a Particular Farm's Object with Full Details

## Get a specific farm's object with full details

<mark style="color:blue;">`GET`</mark> `https://api.tokensfarm.com/farm/config?symbol=HORD&type=LP&nonce=2`

must be filtered by symbol, type and nonce

#### Path Parameters

| Name   | Type    | Description                                                                                                                             |
| ------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| symbol | String  | <p>the symbol of the specific token<br>for example: token=PORTX</p>                                                                     |
| type   | String  | <p>farm\_type=LP,STAKING<br>will return all the lp and staking farms</p>                                                                |
| nonce  | Integer | <p>nonce will be a count of the amount of time farms made for this token.</p><p>you can find a farm nonce with "Get farms list" API</p> |

{% tabs %}
{% tab title="200: OK Farm full info successfully fetched" %}
response example:\
&#x20;<https://api.tokensfarm.com/farm/config?symbol=HORD&type=LP&nonce=2>
{% endtab %}
{% endtabs %}
