/TILs

This endpoint returns status of wellpads which are being monitored for Turn-In-Line (TIL) events. It includes wellpads identified as having a delayed TIL (DTIL) status, as well as those without delays.

Warning

A throttling mechanism with a rate limit of 300 requests per minute has been implemented for this endpoint. This is temporary and may be adjusted in the future.

Endpoint

GET	https://hyperion.api.synmax.com/v3/tils

Usage

Python

fetch_tils()

Returns number of DTIL wells on a wellpad, the operator name, frac job date and the til_date.

This function takes no parameters.

Object returned is a pandas DataFrame.

⮞ Setup the client.

from synmax.hyperion import HyperionApiClient, ApiPayload
access_token = 'your access token goes here'
client = HyperionApiClient(access_token=access_token)

For a more detailed guide on setting up the Hyperion client, please see the Quickstart page.

⮞ Call the function.

result_df = client.fetch_tils()

⮞ Print the results or save them for later.

# Print the entire response as a string.
print(result_df.to_string())

# Create a CSV file from the output.
result_df.to_csv('output.csv')

# Print the number of items per column.
print(result_df.count())

For more information on outputting to different formats, please see the pandas DataFrame documentation.

Response

Parameter	Type	Description	Example
bcfd	float	The total expected production from the DTIL wells on the wellpad	0.087
frac_end	string	The date the frac job ended for the DTIL wells, if NULL then the wells have not completed fracking - Date formatting - [“YYYY-MM-DD”]	“2023-08-26”
operator_name	string	Operator of the wellpad.	“CHK”
sub_region	string	Aggregation of several counties, typically representing a major producing basin.	“S LA”
til_date	string	The date the wells were TILd, if NULL then the wells are currently DTILs - Date formatting - [“YYYY-MM-DD”]	“2023-10-06”
wellpad_id	string	Identifier of the wellpad.	“27248”
wells	integer	The number of DTIL wells on the wellpad	2

---

Responses

Normal Output

bcfd	frac_end	operator_name	sub_region	til_date	wellpad_id	wells
0.042	2024-02-05	CHK	Haynesville - LA	2024-07-24	460260	3
0.087	2024-02-10	CHK	NE PA	2024-10-17	474699	3
0.108	2024-02-20	CHK	NE PA	2024-07-03	453480	4
0.105	2024-02-20	CHK	NE PA	2024-07-24	478279	3
0.044	2024-04-05	CHK	Haynesville - LA	2024-07-24	412674	2
0.063	2024-08-05	CHK	Haynesville - LA	2024-09-10	479553	3

Note

Output data will return as “null” when input data is invalid or does not exist.