Skip to content
Neptune API v2
Get started
API Reference
Swap
Routes

Get swap routes for a denom

swap.routes.list_by_denom(RouteListByDenomParams**kwargs) -> RouteListByDenomResponse
GET/api/v1/swap/routes

Get swap routes for a denom

ParametersExpand Collapse
contract_address: str

Swap contract address

source_denom: str

Source asset denom to fetch target routes for

Note: This is a normal injective asset denom, and not an AssetSpec ID.

E.g.

  • inj is a valid value for source_denom.
  • native;inj is not a valid value for source_denom.
ReturnsExpand Collapse
class RouteListByDenomResponse: …
source: str

Source denom for swap routes

targets: List[str]

List of target denoms for available swap routes

error: None

Error data. Guaranteed null for successful response.

status: int

HTTP status. Successful responses are guaranteed to be < 400. Conversely, error responses are guaranteed to be >= 400.

formatuint16
minimum0
maximum65535
status_text: str

HTTP status text

Get swap routes for a denom

from neptune_api_v2 import NeptuneAPIV2

client = NeptuneAPIV2()
response = client.swap.routes.list_by_denom(
    contract_address="injvalcons1a03k0ztfyjnd70apawva003pkh0adqmau0a9q0",
    source_denom="source_denom",
)
print(response.data)
{
  "data": {
    "source": "inj",
    "targets": [
      "ibc/F6CC233E5C0EA36B1F74AB1AF98471A2D6A80E2542856639703E908B4D93E7C4",
      "peggy0xAaEf88cEa01475125522e117BFe45cF32044E238"
    ]
  },
  "error": null,
  "status": 200,
  "status_text": "200 OK"
}
{
  "data": null,
  "error": {
    "kind": "internal",
    "scope": "server",
    "message": "An unexpected error occurred"
  },
  "status": 500,
  "status_text": "500 Internal Server Error"
}
Returns Examples
{
  "data": {
    "source": "inj",
    "targets": [
      "ibc/F6CC233E5C0EA36B1F74AB1AF98471A2D6A80E2542856639703E908B4D93E7C4",
      "peggy0xAaEf88cEa01475125522e117BFe45cF32044E238"
    ]
  },
  "error": null,
  "status": 200,
  "status_text": "200 OK"
}
{
  "data": null,
  "error": {
    "kind": "internal",
    "scope": "server",
    "message": "An unexpected error occurred"
  },
  "status": 500,
  "status_text": "500 Internal Server Error"
}