Data

Token information, price estimates, and network data.

Use these to validate tokens and check prices before trading.

Get token information

get

/api/v1/token-info

Get detailed token metadata, pool information, trading fees, and security audit.

Use cases:

Validate token before trading
Check buy/sell taxes
Verify liquidity levels
Check security audit status
Display token details in UI

Recommended: Always check token info before first trade to verify:

Token has sufficient liquidity
Buy/sell taxes are reasonable
Token is not a scam (check audit status)

Security Audit:

EVM chains: Uses SerializedAudit API
Solana: Uses Jupiter Shield API

Performance: Set audit=false to skip the security audit check and improve response time by ~50-100ms.

Authorizations

AuthorizationstringRequired

API key authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Contact [email protected] to obtain an API key.

Query parameters

tokenstringRequired

Token contract address

Example: 0x08978686e93859c41e9f8983c1c8523df98c2bf5

chainstringOptional

Blockchain network (auto-detected if not provided)

Example: BASE

auditbooleanOptional

Enable security audit check (default: true). Set to false to skip audit and improve response time by ~50-100ms. The audit field will be omitted from the response when disabled.

Default: trueExample: true

Responses

200

Token information retrieved successfully

application/json

404

Resource not found (token, pool, or route)

application/json

get

/api/v1/token-info

GET /api/v1/token-info?token=text HTTP/1.1
Host: api.naos.trade
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "tokenInfo": {
    "token": {
      "address": "0xFb31f85A8367210B2e4Ed2360D2dA9Dc2D2Ccc95",
      "symbol": "EDEL",
      "name": "Edel Token",
      "decimals": 18
    },
    "chain": "BASE"
  },
  "poolInfo": {
    "type": "UNISWAP V4",
    "factory": "APE.STORE",
    "liquidity": 123456.78,
    "marketCap": 987654.32,
    "priceNative": 0.0000123,
    "priceUsd": 0.045
  },
  "misc": {
    "buyTax": 0,
    "sellTax": 0,
    "burnt": "0",
    "clogged": "0",
    "dexPaid": "NOT_PAID",
    "buyFeeUsd": 1,
    "sellFeeUsd": 1,
    "audit": "safe"
  }
}

Fast price estimate (no simulation)

get

/api/v1/value

Get a fast price estimate without transaction simulation or slippage calculation.

Use cases:

Display prices in UI
Quick price checks
Price change monitoring
Get USD value of trader's token holdings (when amount is omitted)

Amount parameter behavior:

BUY side: amount is required (amount in native token)
SELL side:
- If amount provided: uses that amount
- If amount omitted: requires trader parameter and uses trader's entire token balance

Important:

Does NOT account for slippage
Does NOT simulate transaction
Does NOT guarantee actual output
NOT available on Solana (for amount omitted)

For actual trading, always use /quote instead

Examples:

With amount:

GET /api/v1/value?token=0x...&side=SELL&trader=0xYourWallet&amount=100

Without amount (uses trader's entire balance):

GET /api/v1/value?token=0x...&side=SELL&trader=0xYourWallet

This will fetch the trader's entire token balance and calculate its USD value.

Authorizations

AuthorizationstringRequired

API key authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Contact [email protected] to obtain an API key.

Query parameters

tokenstringRequired

Token contract address

Example: 0x08978686e93859c41e9f8983c1c8523df98c2bf5

sidestring · enumRequired

Trade direction

Example: BUYPossible values:

traderstringRequired

Wallet address (required). Used to fetch the trader's token balance when amount is omitted.

Example: 0xA73CDDdea07E805228Ef6BbbC6216112E3A51723

amountnumberOptional

Amount to trade.

Required for BUY side
Optional for SELL side (if omitted, uses trader's entire balance)

Example: 0.1

chainstringOptional

Blockchain network

Example: BASE

Responses

200

Price estimate

application/json

400

Invalid request parameters

application/json

404

Pool not found or no balance

application/json

get

/api/v1/value

GET /api/v1/value?token=text&side=BUY&trader=text HTTP/1.1
Host: api.naos.trade
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "inputAddress": "0x4200000000000000000000000000000000000006",
  "inputAmount": 0.1,
  "outputAddress": "0x08978686e93859c41e9f8983c1c8523df98c2bf5",
  "outputAmount": 121935458.25,
  "side": "BUY",
  "cumulativePoolFee": 43100
}

Get gas priority fees

get

/api/v1/priority

Get current gas fee estimates for different priority levels.

Use cases:

Check gas prices before trading
Select appropriate priority level
Monitor network congestion

Priority levels:

LOW: Cheapest, slower
MEDIUM: Standard (recommended)
HIGH: Faster, more expensive
INSTANT: Fastest, highest cost

Authorizations

AuthorizationstringRequired

API key authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Contact [email protected] to obtain an API key.

Query parameters

chainstringRequired

Blockchain network

Example: BASE

Responses

200

Gas fee estimates

application/json

get

/api/v1/priority

GET /api/v1/priority?chain=text HTTP/1.1
Host: api.naos.trade
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Gas fee estimates

{
  "success": true,
  "chain": "BASE",
  "fees": {
    "LOW": {
      "maxFeePerGas": "0.000000001",
      "maxPriorityFeePerGas": "0.000000001",
      "gasPrice": "0.000000001"
    },
    "MEDIUM": {
      "maxFeePerGas": "0.000000002",
      "maxPriorityFeePerGas": "0.000000002",
      "gasPrice": "0.000000002"
    },
    "HIGH": {
      "maxFeePerGas": "0.000000005",
      "maxPriorityFeePerGas": "0.000000005",
      "gasPrice": "0.000000005"
    },
    "INSTANT": {
      "maxFeePerGas": "0.000000010",
      "maxPriorityFeePerGas": "0.000000010",
      "gasPrice": "0.000000010"
    }
  }
}

Get supported chains

get

/api/v1/chain

Get list of all supported blockchain networks with their configurations.

Information provided:

Network name and chain ID
Native token symbol
Router contract address

Networks: Base, ETH, BSC, ARB, AVAX, Abstract, HyperEVM, Ink, Story, X Layer, Plasma, UniChain, Solana

Authorizations

AuthorizationstringRequired

API key authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Contact [email protected] to obtain an API key.

Responses

200

List of supported chains

application/json

get

/api/v1/chain

GET /api/v1/chain HTTP/1.1
Host: api.naos.trade
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of supported chains

{
  "success": true,
  "chains": [
    {
      "name": "BASE",
      "chainId": 8453,
      "nativeToken": "ETH",
      "routerAddress": "0xEF75C09BcfA1Eb60215eE6Ecfdf6c6Be8C82a862"
    },
    {
      "name": "ETH",
      "chainId": 1,
      "nativeToken": "ETH",
      "routerAddress": "0x9fABC532D0267b9Ab34A942DDfc58185c392a553"
    },
    {
      "name": "BSC",
      "chainId": 56,
      "nativeToken": "BNB",
      "routerAddress": "0x6F9C121535Af587921F2F68B77c723Ba3B842E6F"
    }
  ]
}

Get native token balance

get

/api/v1/balance

Retrieve the native token balance for a wallet address on a specific network.

Use cases:

Check wallet balance before trading
Verify sufficient funds for transaction
Display wallet balance in UI
Monitor balance changes

Native tokens:

EVM chains: ETH, BNB, AVAX, etc. (18 decimals)
Solana: SOL (9 decimals)

Balance format: The balance is returned in raw token units:

EVM: wei (divide by 10^18 to get native token amount)
Solana: lamports (divide by 10^9 to get SOL)

Example calculations:

Balance "1500000000000000000" with decimals 18 = 1.5 ETH
Balance "1500000000" with decimals 9 = 1.5 SOL

Authorizations

AuthorizationstringRequired

API key authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Contact [email protected] to obtain an API key.

Query parameters

walletstringRequired

Wallet address to check balance for.

EVM chains: 0x... format (42 characters)
Solana: Base58 format (32-44 characters)

Example: 0xA73CDDdea07E805228Ef6BbbC6216112E3A51723

networkstring · enumRequired

Blockchain network to check balance on.

Supported networks: BASE, ETH, BSC, ARB, AVAX, ABS, HYPE, INK, STORY, XLAYER, PLASMA, UNI, SOL

Example: BASEPossible values:

Responses

200

Balance retrieved successfully

application/json

400

Invalid request parameters or malformed request

application/json

401

Missing or invalid API key

application/json

500

Internal server error

application/json

get

/api/v1/balance

GET /api/v1/balance?wallet=text&network=BASE HTTP/1.1
Host: api.naos.trade
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "balance": "125103933760140349",
  "decimals": 18
}

Get token balance

get

/api/v1/token-balance

Retrieve the balance of a specific ERC-20 or SPL token for a wallet address on a specific network.

Use cases:

Check token balance before selling
Verify token holdings
Display token portfolio in UI
Calculate available sell amount

Token types:

EVM: ERC-20 tokens (variable decimals, typically 6, 8, or 18)
Solana: SPL tokens (variable decimals, typically 6 or 9)

Balance format: The balance is returned in raw token units. Use the decimals field to format correctly.

Example calculations:

Balance "5000000" with decimals 6 = 5.0 USDC
Balance "1000000000000000000" with decimals 18 = 1.0 token

Note: Token decimals are automatically fetched from the token contract or pool info.

Authorizations

AuthorizationstringRequired

API key authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Contact [email protected] to obtain an API key.

Query parameters

walletstringRequired

Wallet address to check token balance for.

EVM chains: 0x... format (42 characters)
Solana: Base58 format (32-44 characters)

Example: 0xA73CDDdea07E805228Ef6BbbC6216112E3A51723

tokenstringRequired

Token contract address to check balance for.

EVM: 0x... format (42 characters)
Solana: Base58 format (32-44 characters)

Example: 0xFb31f85A8367210B2e4Ed2360D2dA9Dc2D2Ccc95

networkstring · enumRequired

Blockchain network where the token exists.

Supported networks: BASE, ETH, BSC, ARB, AVAX, ABS, HYPE, INK, STORY, XLAYER, PLASMA, UNI, SOL

Example: BASEPossible values:

Responses

200

Token balance retrieved successfully

application/json

400

Invalid request parameters or malformed request

application/json

401

Missing or invalid API key

application/json

500

Internal server error

application/json

get

/api/v1/token-balance

GET /api/v1/token-balance?wallet=text&token=text&network=BASE HTTP/1.1
Host: api.naos.trade
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "balance": "354749157803150317450",
  "decimals": 18
}

PreviousTrading NextSystem

Last updated 8 days ago

Good evening

Get token information

Fast price estimate (no simulation)

Get gas priority fees

Get supported chains

Get native token balance

Get token balance