Client

class intents.client.IntentsClient(jwt_token=None, base_url='https://1click.chaindefuser.com', timeout=30.0)[source]

Bases: object

Async client for the NEAR Intents 1Click Swap API.

Can be used as an async context manager or standalone. When used standalone, call aclose() when finished.

Parameters:

  • jwt_token (str | None) – Optional Bearer JWT token for authenticated endpoints.

  • base_url (str) – Override the default API base URL.

  • timeout (float) – Request timeout in seconds (default: 30).

async aclose()[source]
Return type:

None

async get_tokens()[source]

Retrieve all tokens supported by the 1Click API.

Return type:

list[TokenResponse]

Returns:

List of TokenResponse objects.

async get_quote(request)[source]

Request a swap quote.

Pass dry=True on the request to simulate the quote without generating a deposit address.

Parameters:

request (QuoteRequest) – Swap parameters as a QuoteRequest.

Return type:

QuoteResponse

Returns:

QuoteResponse with the deposit address and expected output amounts.

Raises:
async get_status(deposit_address, deposit_memo=None)[source]

Check the execution status of a swap.

Parameters:

  • deposit_address (str) – The deposit address returned by get_quote().

  • deposit_memo (str | None) – Required for chains that use memo-based deposits.

Return type:

ExecutionStatusResponse

Returns:

ExecutionStatusResponse.

Raises:
async get_any_input_withdrawals(deposit_address, deposit_memo=None, timestamp_from=None, page=None, limit=None, sort_order=None)[source]

Retrieve withdrawals for an ANY_INPUT quote.

Parameters:

  • deposit_address (str) – The deposit address for the quote.

  • deposit_memo (str | None) – Memo used with the deposit, if applicable.

  • timestamp_from (str | None) – ISO timestamp to filter withdrawals from.

  • page (int | None) – Page number for pagination (default: 1).

  • limit (int | None) – Withdrawals per page (max 50, default: 50).

  • sort_order (Optional[Literal['asc', 'desc']]) – "asc" or "desc".

Return type:

AnyInputWithdrawalsResponse

Returns:

AnyInputWithdrawalsResponse.

async submit_deposit(request)[source]

Notify the 1Click service that a deposit transaction has been sent.

This is optional but can speed up swap processing by allowing the service to preemptively verify the deposit.

Parameters:

request (SubmitDepositRequest) – Deposit details as a SubmitDepositRequest.

Return type:

SubmitDepositResponse

Returns:

SubmitDepositResponse.

Raises: