estuary-client.DealsApi

All URIs are relative to https://api.estuary.tech

Method	HTTP request	Description
deal_estimate_post	POST /deal/estimate	Estimate the cost of a deal
deal_info_dealid_get	GET /deal/info/{dealid}	Get Deal Info
deal_proposal_propcid_get	GET /deal/proposal/{propcid}	Get Proposal
deal_query_miner_get	GET /deal/query/{miner}	Query Ask
deal_status_by_proposal_propcid_get	GET /deal/status-by-proposal/{propcid}	Get Deal Status by PropCid
deal_status_miner_propcid_get	GET /deal/status/{miner}/{propcid}	Deal Status
deal_transfer_in_progress_get	GET /deal/transfer/in-progress	Transfer In Progress
deals_failures_get	GET /deals/failures	Get storage failures for user
deals_make_miner_post	POST /deals/make/{miner}	Make Deal
deals_status_deal_get	GET /deals/status/{deal}	Get Deal Status
public_deals_failures_get	GET /public/deals/failures	Get storage failures
public_miners_storage_query_miner_get	GET /public/miners/storage/query/{miner}	Query Ask

deal_estimate_post

deal_estimate_post(body)

Estimate the cost of a deal

This endpoint estimates the cost of a deal

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
body = estuary-client.MainEstimateDealBody() # MainEstimateDealBody | The size of the deal in bytes, the replication factor, and the duration of the deal in blocks

try:
    # Estimate the cost of a deal
    api_instance.deal_estimate_post(body)
except ApiException as e:
    print("Exception when calling DealsApi->deal_estimate_post: %s\n" % e)

Parameters

Name	Type	Description	Notes
body	MainEstimateDealBody	The size of the deal in bytes, the replication factor, and the duration of the deal in blocks

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deal_info_dealid_get

deal_info_dealid_get(dealid)

Get Deal Info

This endpoint returns the deal info for a deal

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
dealid = 56 # int | Deal ID

try:
    # Get Deal Info
    api_instance.deal_info_dealid_get(dealid)
except ApiException as e:
    print("Exception when calling DealsApi->deal_info_dealid_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
dealid	int	Deal ID

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deal_proposal_propcid_get

deal_proposal_propcid_get(propcid)

Get Proposal

This endpoint returns the proposal for a deal

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
propcid = 'propcid_example' # str | Proposal CID

try:
    # Get Proposal
    api_instance.deal_proposal_propcid_get(propcid)
except ApiException as e:
    print("Exception when calling DealsApi->deal_proposal_propcid_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
propcid	str	Proposal CID

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deal_query_miner_get

deal_query_miner_get(miner)

Query Ask

This endpoint returns the ask for a given CID

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
miner = 'miner_example' # str | CID

try:
    # Query Ask
    api_instance.deal_query_miner_get(miner)
except ApiException as e:
    print("Exception when calling DealsApi->deal_query_miner_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
miner	str	CID

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deal_status_by_proposal_propcid_get

deal_status_by_proposal_propcid_get(propcid)

Get Deal Status by PropCid

Get Deal Status by PropCid

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
propcid = 'propcid_example' # str | PropCid

try:
    # Get Deal Status by PropCid
    api_instance.deal_status_by_proposal_propcid_get(propcid)
except ApiException as e:
    print("Exception when calling DealsApi->deal_status_by_proposal_propcid_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
propcid	str	PropCid

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deal_status_miner_propcid_get

deal_status_miner_propcid_get(miner, propcid)

Deal Status

This endpoint returns the status of a deal

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
miner = 'miner_example' # str | Miner
propcid = 'propcid_example' # str | Proposal CID

try:
    # Deal Status
    api_instance.deal_status_miner_propcid_get(miner, propcid)
except ApiException as e:
    print("Exception when calling DealsApi->deal_status_miner_propcid_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
miner	str	Miner
propcid	str	Proposal CID

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deal_transfer_in_progress_get

deal_transfer_in_progress_get()

Transfer In Progress

This endpoint returns the in-progress transfers

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))

try:
    # Transfer In Progress
    api_instance.deal_transfer_in_progress_get()
except ApiException as e:
    print("Exception when calling DealsApi->deal_transfer_in_progress_get: %s\n" % e)

Parameters

This endpoint does not need any parameter.

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deals_failures_get

deals_failures_get()

Get storage failures for user

This endpoint returns a list of storage failures for user

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))

try:
    # Get storage failures for user
    api_instance.deals_failures_get()
except ApiException as e:
    print("Exception when calling DealsApi->deals_failures_get: %s\n" % e)

Parameters

This endpoint does not need any parameter.

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deals_make_miner_post

deals_make_miner_post(miner, deal_request)

Make Deal

This endpoint makes a deal for a given content and miner

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
miner = 'miner_example' # str | Miner
deal_request = 'deal_request_example' # str | Deal Request

try:
    # Make Deal
    api_instance.deals_make_miner_post(miner, deal_request)
except ApiException as e:
    print("Exception when calling DealsApi->deals_make_miner_post: %s\n" % e)

Parameters

Name	Type	Description	Notes
miner	str	Miner
deal_request	str	Deal Request

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deals_status_deal_get

deals_status_deal_get(deal)

Get Deal Status

This endpoint returns the status of a deal

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
deal = 56 # int | Deal ID

try:
    # Get Deal Status
    api_instance.deals_status_deal_get(deal)
except ApiException as e:
    print("Exception when calling DealsApi->deals_status_deal_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
deal	int	Deal ID

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

public_deals_failures_get

public_deals_failures_get()

Get storage failures

This endpoint returns a list of storage failures

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))

try:
    # Get storage failures
    api_instance.public_deals_failures_get()
except ApiException as e:
    print("Exception when calling DealsApi->public_deals_failures_get: %s\n" % e)

Parameters

This endpoint does not need any parameter.

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

public_miners_storage_query_miner_get

public_miners_storage_query_miner_get(miner)

Query Ask

This endpoint returns the ask for a given CID

Example

from __future__ import print_function
import time
import estuary-client
from estuary-client.rest import ApiException
from pprint import pprint

# Configure API key authorization: bearerAuth
configuration = estuary-client.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = estuary-client.DealsApi(estuary-client.ApiClient(configuration))
miner = 'miner_example' # str | CID

try:
    # Query Ask
    api_instance.public_miners_storage_query_miner_get(miner)
except ApiException as e:
    print("Exception when calling DealsApi->public_miners_storage_query_miner_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
miner	str	CID

Return type

void (empty response body)

Authorization

bearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]