Skip to main content
POST
/
#particle_swap_getQuote
getQuote
curl --request POST \
  --url 'https://rpc.particle.network/evm-chain/#particle_swap_getQuote' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "particle_swap_getQuote",
  "params": [
    "0x369aa8a7a7BE683E1a46d9A056806B2B3FD778C8"
  ],
  "chainId": 1
}
'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "fromToken": {
      "chainId": 1,
      "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "symbol": "DAI",
      "name": "Dai Stablecoin",
      "decimals": 18,
      "logoURI": "https://static.particle.network/token-list/ethereum/0x6B175474E89094C44Da98b954EedeAC495271d0F.png"
    },
    "toToken": {
      "chainId": 1,
      "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "symbol": "DAI",
      "name": "Dai Stablecoin",
      "decimals": 18,
      "logoURI": "https://static.particle.network/token-list/ethereum/0x6B175474E89094C44Da98b954EedeAC495271d0F.png"
    },
    "toTokenAmount": "781970036",
    "fromTokenAmount": "1000000000",
    "estimatedGas": "0x4079f"
  },
  "chainId": 1
}

​
Understanding getQuote

  • getQuote calculates and returns the quote price for the swap (the amount of toTokenAddress tokens you’ll receive) alongside details about the swap. It takes:
    • address - string.
    • Swap information object:
      • fromTokenAddress - string.
      • toTokenAddress - string.
      • amount - string.

​
Query example

JSON
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "particle_swap_getQuote",
  "params": [
    "0x369aa8a7a7BE683E1a46d9A056806B2B3FD778C8", // wallet address
    {
      "fromTokenAddress": "0x111111111117dc0aa78b770fa6a738034120c302",
      "toTokenAddress": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "amount": "1000000000"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Request to get a quote for a token swap.

​
jsonrpc
string
default:2.0
required

Version of the JSON-RPC protocol, should be 2.0.

Example:

"2.0"

​
id
integer
default:1
required

The request identifier.

Example:

1

​
method
enum<string>
required

API method being called.

Available options:
particle_swap_getQuote
​
params
(string | object)[]
required

Parameters for getting a swap quote.

User address.

Example:

"0x369aa8a7a7BE683E1a46d9A056806B2B3FD778C8"

​
chainId
integer

The blockchain chain ID.

Example:

1

Response

200 - application/json

Successful response with swap quote.

​
jsonrpc
string
default:2.0
required

Version of the JSON-RPC protocol, should be 2.0.

Example:

"2.0"

​
id
integer
default:1
required

The request identifier.

Example:

1

​
result
object
required

Swap quote details.

​
chainId
integer

The blockchain chain ID.

Example:

1