Assets

Endpoints for asset pair operations, liquidity pools, and swap analytics

Get All Pools

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/pools

Retrieves all available liquidity pools.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

sortBystring · enumOptionalPossible values:

sortOrderstring · enumOptionalPossible values:

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/pools

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/pools HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "pools": [],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Pool Infos by Denom

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/pools/byDenom

Retrieves pool information filtered by denomination.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

denomstringRequired

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/pools/byDenom

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/pools/byDenom?denom=text HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "pools": [],
  "denom": "text",
  "count": 1
}

Get Pool Infos by Assets

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/pools/byAssets

Retrieves pool information filtered by specific assets.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

asset1stringRequired

asset2stringOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/pools/byAssets

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/pools/byAssets?asset1=text HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "pools": [],
  "asset1": "text",
  "asset2": "text",
  "count": 1
}

Get Pool Info by ID

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/pools/{poolId}

Retrieves detailed information for a specific pool by its ID.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

poolIdstringRequired

Query parameters

poolIdstringRequired

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/pools/{poolId}

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/pools/{poolId}?poolId=text HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "success": true,
  "poolInfo": null
}

Estimate Swap

post

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/swaps/estimate

Estimates the output amount for a swap operation.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Body

application/json

tokenInstringRequired

tokenOutDenomstringRequired

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

post

/api/{version}/swaps/estimate

HTTPcURLJavaScriptPython

POST /api/v0/api/{version}/swaps/estimate HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "tokenIn": "text",
  "tokenOutDenom": "text"
}

{
  "success": true,
  "estimate": {
    "tokenOutAmount": "text",
    "tokenInAmount": "text",
    "allRoutes": [],
    "lowLiqudiityWarning": true
  }
}

Get Asset Pairs

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs

Retrieves all available asset pairs.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

sortBystring · enumOptionalPossible values:

sortDirectionstring · enumOptionalPossible values:

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Top Gainers

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/topGainers

Retrieves asset pairs with the highest price gains.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/topGainers

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/topGainers HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Top Losers

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/topLosers

Retrieves asset pairs with the highest price losses.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/topLosers

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/topLosers HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Highest Volume

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/highestVolume

Retrieves asset pairs with the highest trading volume.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/highestVolume

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/highestVolume HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get by Price

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/priceSorted

Retrieves asset pairs sorted by price.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

sortDirectionstring · enumOptionalPossible values:

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/priceSorted

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/priceSorted HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Weekly Top Gainers

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/weeklyTopGainers

Retrieves asset pairs with the highest weekly price gains.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/weeklyTopGainers

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/weeklyTopGainers HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Weekly Top Losers

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/weeklyTopLosers

Retrieves asset pairs with the highest weekly price losses.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

bookmarkstringOptional

limitnumberOptional

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/weeklyTopLosers

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/weeklyTopLosers HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Search Asset Pairs by Text

get

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/search

Searches asset pairs by text query.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Query parameters

querystringRequired

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

get

/api/{version}/assetPairs/search

HTTPcURLJavaScriptPython

GET /api/v0/api/{version}/assetPairs/search?query=text HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Accept: */*

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}

Get Asset Pairs by Denoms

post

https://api.bitbadges.io/api/v0https://api.bitbadges.io/testnet/api/v0

/api/{version}/assetPairs/byDenoms

Retrieves asset pairs filtered by specific denominations.

SDK Links:

• Request Type

• Response Type

Authorizations

apiKey

Path parameters

versionstringRequired

Header parameters

x-api-keystringRequired

BitBadges API Key for authentication

Body

application/json

denomsstring[]Required

Responses

200

Success response

application/json

400

Bad Request - Invalid configuration or request

application/json

500

Internal Server Error

application/json

post

/api/{version}/assetPairs/byDenoms

HTTPcURLJavaScriptPython

POST /api/v0/api/{version}/assetPairs/byDenoms HTTP/1.1
Host: api.bitbadges.io
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "denoms": [
    "text"
  ]
}

{
  "assetPairs": [
    {
      "_id": "text",
      "_docId": "text",
      "asset": "text",
      "price": 1,
      "lastUpdated": 1,
      "totalLiquidity": [],
      "volume24h": 1,
      "volume7d": 1,
      "percentageChange24h": 1,
      "percentageChange7d": 1,
      "info": null
    }
  ],
  "pagination": {
    "bookmark": "text",
    "hasMore": true
  }
}