Native Quote

Get quotes for swapping between native currency and tokens

get

Returns the best quote for buying or selling tokens with native currency. Token decimals are automatically detected using ERC20 standard calls.

Query parameters

actionstring · enumrequired

The swap direction - either buy tokens with native currency, or sell tokens for native currency

Example: buyAvailable options:

tokenAddressstringrequired

The token address to buy or sell

Example: 0x1234567890123456789012345678901234567890Pattern: ^0x[a-fA-F0-9]{40}$

amountstringrequired

The amount as a BigInt string. For buy - This is the amount of native currency to spend. For sell - This is the amount of tokens to sell.

Example: 1000000000000000000

feeBpsinteger · max: 10000optional

Partner fee in basis points (0-10000)

Example: 25

feeRecipientstringoptional

Address to receive the partner fee

Example: 0xabcdef1234567890abcdef1234567890abcdef12Pattern: ^0x[a-fA-F0-9]{40}$

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.coal.ag/api/v1/quotes/native?action=buy&tokenAddress=0x1234567890123456789012345678901234567890&amount=1000000000000000000'

200

400

404

500

200

{
  "amountOutNative": "985000000000000000",
  "quoteData": "eyJ0b2tlbk91dCI6IjB4MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MCIsImFtb3VudEluTmF0aXZlIjoiMTAwMDAwMDAwMDAwMDAwMDAwMCIsImFtb3VudE91dEluVG9rZW5zIjoiOTg1MDAwMDAwMDAwMDAwMDAwIiwidG9rZW5PdXREZWNpbWFscyI6MTgsImV4Y2hhbmdlIjowLCJwYXJhbXMiOnsic3RhYmxlIjpmYWxzZSwidGlja1NwYWNpbmciOjAsImZlZSI6MCwiYmluU3RlcCI6IjAiLCJyZXZlcnNlZCI6ZmFsc2V9fQ=="
}

Successful quote response