thorchain_rujira_range_order_list · MCP API Docs

JSON-RPC call

Paste this body into your MCP client's `tools/call` request. The `id` field is the JSON-RPC message correlator (caller-chosen, not a record identifier — set it to anything; the server echoes it back).

tools/call body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "thorchain_rujira_range_order_list",
    "arguments": {
      "owner_address": "<owner_address>",
      "trade_contract_id": 1,
      "limit": 1,
      "cursor": "<cursor>"
    }
  }
}

Arguments

Name	Type	Required	Description
`owner_address`	string	optional	Filter to orders whose owner_address_str matches.
`trade_contract_id`	integer	optional	Filter to orders against this Rujira trade contract.
`limit`	integer	optional	Page size (default 50, max 200).
`cursor`	string	optional	Opaque cursor from a prior next_cursor.

Copy-paste prompt samples

Drop one of these into Claude Code, n8n, or any MCP client. Your AI agent should pick this tool to answer.

List the open Rujira range orders for owner thor1abc...xyz.

Show me the first 50 range orders against trade contract id 12.

Page through every Rujira range order — give me a cursor to continue.

Which range orders has the address thor1...xyz placed on the BTC/RUNE pair?

Example response

Illustrative shape — actual values vary.

response shape

{
  "items": [
    {
      "id": 4521,
      "rujira_range_order_id": "17",
      "owner_address_str": "thor1abc...xyz",
      "owner_address": {
        "address": "thor1abc...xyz",
        "name": null,
        "network": {
          "slug": "mainnet-thorchain",
          "name": "THORChain",
          "thorchain_symbol": "THOR"
        }
      },
      "trade_contract": {
        "contract_id": 12,
        "pair_name": "BTC/RUNE",
        "base_symbol": "BTC",
        "quote_symbol": "RUNE"
      },
      "idx": 0,
      "low": "50000",
      "high": "60000",
      "spread": "5",
      "fees_base": "0.0",
      "fees_quote": "0.0",
      "total_invested": "4500000.0",
      "value_usd": "4521234.56"
    }
  ],
  "next_cursor": "aWQ6NDUyMQ"
}

Possible errors

VALIDATION: Returned when the arguments fail the typed schema.
NOT_FOUND: Returned when the requested resource does not exist in our DB.
RATE_LIMIT: Returned when your token's credit budget is exhausted.