> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tokensfarm.com/for-developers/integrate-tokensfarm/get-farm-address-and-full-details.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.