Read-only THORChain data: pools, network, nodes, vaults, transactions, Midgard history.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.
The asset (e.g. BTC.BTC)
The transaction amount in base units
Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The asset (e.g. BTC.BTC) |
| amount* | string | The transaction amount in base units |
{
"type": "object",
"required": [
"asset",
"amount"
],
"properties": {
"asset": {
"type": "string",
"description": "The asset (e.g. BTC.BTC)"
},
"amount": {
"type": "string",
"description": "The transaction amount in base units"
}
},
"additionalProperties": false
}Returns affiliate earnings including fees collected by thorname.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns historical affiliate swap data including volumes and thorname breakdown over time.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns affiliate statistics including volumes, counts, and fees by thorname.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the ban status for a node address. Shows if the node is banned, at what block height, and which nodes signed the ban. Bans are used to remove malicious or misbehaving nodes.
| Argument | Type | Description |
|---|---|---|
| address* | string | The node address to check ban status for (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The node address to check ban status for (thor1...)"
}
},
"additionalProperties": false
}Returns verbose details of a THORChain block including header info, transactions, and block events. If no height is specified, returns the latest block. Shows block hash, chain ID, height, time, validator info, and all transactions with their results.
| Argument | Type | Description |
|---|---|---|
| height | null | integer | Optional block height. If not provided returns the latest block. |
{
"type": "object",
"properties": {
"height": {
"type": [
"null",
"integer"
],
"description": "Optional block height. If not provided returns the latest block."
}
},
"additionalProperties": false
}Returns bond details for an address including associated nodes and total bonded amount.
| Argument | Type | Description |
|---|---|---|
| address* | string | Address to get bond details for |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Address to get bond details for"
}
},
"additionalProperties": false
}Returns churn event history with dates and block heights.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns block data at the specified height including header, transactions, and commit signatures. Provides canonical blockchain data.
| Argument | Type | Description |
|---|---|---|
| height | integer | Block height to query. If omitted or 0, returns the latest block. |
{
"type": "object",
"properties": {
"height": {
"type": "integer",
"description": "Block height to query. If omitted or 0, returns the latest block."
}
},
"additionalProperties": false
}Returns the results of executing transactions in a block, including ABCI events and validator updates. Useful for inspecting transaction outcomes.
| Argument | Type | Description |
|---|---|---|
| height | integer | Block height to query. If omitted or 0, returns results for the latest block. |
{
"type": "object",
"properties": {
"height": {
"type": "integer",
"description": "Block height to query. If omitted or 0, returns results for the latest block."
}
},
"additionalProperties": false
}Returns CometBFT consensus parameters (block size, evidence, validator params) at a height.
| Argument | Type | Description |
|---|---|---|
| height | integer | Block height (0 or omitted for latest) |
{
"type": "object",
"properties": {
"height": {
"type": "integer",
"description": "Block height (0 or omitted for latest)"
}
},
"additionalProperties": false
}Returns the current consensus round state including height/round/step, proposal block hash, and vote information. Useful for debugging consensus issues.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns network information including listening status, connected peers, and peer details. Useful for monitoring P2P network health.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the CometBFT node status including node info, sync status, and validator information. Provides canonical consensus-level data about the blockchain.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns a transaction by its hash including tx result, height, and optional proof of inclusion. Provides canonical transaction data from the consensus layer.
| Argument | Type | Description |
|---|---|---|
| hash* | string | Transaction hash (without 0x prefix). |
| prove | boolean | Include proof of transaction inclusion. |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "Transaction hash (without 0x prefix)."
},
"prove": {
"type": "boolean",
"description": "Include proof of transaction inclusion."
}
},
"additionalProperties": false
}Returns the validator set at the specified height including addresses, public keys, and voting power. This is canonical consensus data about who can produce blocks.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). Default is 1. |
| height | integer | Block height to query. If omitted or 0, returns the current validator set. |
| per_page | integer | Number of validators per page. Default is 30, max is 100. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Page number for pagination (1-indexed). Default is 1."
},
"height": {
"type": "integer",
"description": "Block height to query. If omitted or 0, returns the current validator set."
},
"per_page": {
"type": "integer",
"description": "Number of validators per page. Default is 30, max is 100."
}
},
"additionalProperties": false
}Returns protocol constants including integer, boolean, and string configuration values that govern THORChain behavior.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns account information for a THORChain address including account number, sequence (nonce), and public key if available.
| Argument | Type | Description |
|---|---|---|
| address* | string | THORChain address (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "THORChain address (thor1...)"
}
},
"additionalProperties": false
}Returns account balances for a THORChain address. Shows all coin denominations held by the account.
| Argument | Type | Description |
|---|---|---|
| address* | string | THORChain address (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "THORChain address (thor1...)"
}
},
"additionalProperties": false
}Returns a block at the specified height from the Cosmos SDK blockchain including header, transactions, and commit data.
| Argument | Type | Description |
|---|---|---|
| height* | integer | Block height to query |
{
"type": "object",
"required": [
"height"
],
"properties": {
"height": {
"type": "integer",
"description": "Block height to query"
}
},
"additionalProperties": false
}Returns all delegations for a delegator address. Shows which validators the address has delegated to and the amounts.
| Argument | Type | Description |
|---|---|---|
| delegator_addr* | string | Delegator address (thor1...) |
{
"type": "object",
"required": [
"delegator_addr"
],
"properties": {
"delegator_addr": {
"type": "string",
"description": "Delegator address (thor1...)"
}
},
"additionalProperties": false
}Returns the latest block from the Cosmos SDK blockchain including header, transactions, and commit data.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns Cosmos SDK node information including network, version, protocol versions, and application version. Uses the gRPC-gateway REST API for canonical data.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns delegation rewards for a delegator address. Shows rewards from each validator and total accumulated rewards.
| Argument | Type | Description |
|---|---|---|
| delegator_addr* | string | Delegator address (thor1...) |
{
"type": "object",
"required": [
"delegator_addr"
],
"properties": {
"delegator_addr": {
"type": "string",
"description": "Delegator address (thor1...)"
}
},
"additionalProperties": false
}Returns the total token supply including all coin denominations. Shows the circulating supply of RUNE and other tokens.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns whether the node is currently syncing with the blockchain. A syncing node may have stale data.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns a transaction by hash from the Cosmos SDK blockchain. Includes transaction body, auth info, and execution result.
| Argument | Type | Description |
|---|---|---|
| hash* | string | Transaction hash |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "Transaction hash"
}
},
"additionalProperties": false
}Returns the list of staking validators. Includes operator address, status, tokens, delegator shares, commission rates, and description.
| Argument | Type | Description |
|---|---|---|
| status | string | Filter by validator status: BOND_STATUS_BONDED, BOND_STATUS_UNBONDING, or BOND_STATUS_UNBONDED. Leave empty for all. |
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Filter by validator status: BOND_STATUS_BONDED, BOND_STATUS_UNBONDING, or BOND_STATUS_UNBONDED. Leave empty for all."
}
},
"additionalProperties": false
}Returns historical depth data for a pool including asset depth, RUNE depth, asset price, and liquidity units over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| asset* | string | Pool asset identifier (e.g. BTC.BTC) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"asset": {
"type": "string",
"description": "Pool asset identifier (e.g. BTC.BTC)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns one derived (virtual) pool's depths and status.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The derived asset (e.g. THOR.BTC) |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The derived asset (e.g. THOR.BTC)"
}
},
"additionalProperties": false
}Returns per-THORName dynamic L1 minimum swap-fee floors (ADR-026). Each entry shows the enrolled THORName, trading pair, current dynamic fee floor in basis points, whitelist state (1=Active, 2=Monitor), last active epoch, and latest fee revenue in TOR.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns historical earnings data including liquidity fees, block rewards, and bonding/liquidity earnings over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns top RUNE holders with their balances.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns vault addresses for depositing assets into THORChain. Each chain has its own inbound address along with gas rates and halted status.
No arguments.
{
"type": "object",
"additionalProperties": false
}Runs a specific protocol invariant check and returns the result. Shows whether the invariant is broken and any informative messages about the check. Use this to verify protocol consistency and detect potential issues.
| Argument | Type | Description |
|---|---|---|
| invariant* | string | The invariant name to check (e.g. 'asgard', 'bond', 'pools', 'thorchain') |
{
"type": "object",
"required": [
"invariant"
],
"properties": {
"invariant": {
"type": "string",
"description": "The invariant name to check (e.g. 'asgard', 'bond', 'pools', 'thorchain')"
}
},
"additionalProperties": false
}Returns keygen information for a specific block height and pubkey. Shows details of the key generation ceremony including the keygen block, member nodes, and signature. Use this to investigate vault creation events.
| Argument | Type | Description |
|---|---|---|
| height* | integer | The block height of the keygen ceremony |
| pubkey* | string | The pubkey of one of the keygen block members |
{
"type": "object",
"required": [
"height",
"pubkey"
],
"properties": {
"height": {
"type": "integer",
"description": "The block height of the keygen ceremony"
},
"pubkey": {
"type": "string",
"description": "The pubkey of one of the keygen block members"
}
},
"additionalProperties": false
}Returns keygen timing metrics for a specific vault public key.
| Argument | Type | Description |
|---|---|---|
| pubkey* | string | The vault public key (thorpub...) |
{
"type": "object",
"required": [
"pubkey"
],
"properties": {
"pubkey": {
"type": "string",
"description": "The vault public key (thorpub...)"
}
},
"additionalProperties": false
}Returns keysign information for a specific block height. Shows transactions that were scheduled to be signed at that height, including outbound transaction details. Use this to investigate signing operations at a particular block.
| Argument | Type | Description |
|---|---|---|
| height* | integer | The block height to get keysign information for |
{
"type": "object",
"required": [
"height"
],
"properties": {
"height": {
"type": "integer",
"description": "The block height to get keysign information for"
}
},
"additionalProperties": false
}Returns keysign information for a specific block height and vault pubkey. Shows transactions signed by a particular vault at that height. Use this to investigate a specific vault's signing activity.
| Argument | Type | Description |
|---|---|---|
| height* | integer | The block height to get keysign information for |
| pubkey* | string | The vault pubkey to filter keysign information |
{
"type": "object",
"required": [
"height",
"pubkey"
],
"properties": {
"height": {
"type": "integer",
"description": "The block height to get keysign information for"
},
"pubkey": {
"type": "string",
"description": "The vault pubkey to filter keysign information"
}
},
"additionalProperties": false
}Returns known pools with their status (available, staged, suspended).
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the last observed and signed block heights for a specific chain. Useful for monitoring a particular chain's sync status.
| Argument | Type | Description |
|---|---|---|
| chain* | string | The chain to get last block for (e.g. BTC, ETH, THOR) |
{
"type": "object",
"required": [
"chain"
],
"properties": {
"chain": {
"type": "string",
"description": "The chain to get last block for (e.g. BTC, ETH, THOR)"
}
},
"additionalProperties": false
}Returns the limit swaps queue containing pending limit orders. Each entry includes swap details, ratio, age, and expiry information. Supports filtering by source/target asset, sender, and pagination. Limit orders only work when AdvSwapQueueEnabled is true.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Number of items to return (default: 100, max: 1000) |
| offset | integer | Number of items to skip (default: 0) |
| sender | string | Filter by sender address |
| sort_by | string | Sort field: ratio, age, amount, or created_height (default: ratio) |
| sort_order | string | Sort order: asc or desc (default: asc) |
| source_asset | string | Filter by source asset (e.g. BTC.BTC) |
| target_asset | string | Filter by target asset (e.g. ETH.ETH) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Number of items to return (default: 100, max: 1000)"
},
"offset": {
"type": "integer",
"description": "Number of items to skip (default: 0)"
},
"sender": {
"type": "string",
"description": "Filter by sender address"
},
"sort_by": {
"type": "string",
"description": "Sort field: ratio, age, amount, or created_height (default: ratio)"
},
"sort_order": {
"type": "string",
"description": "Sort order: asc or desc (default: asc)"
},
"source_asset": {
"type": "string",
"description": "Filter by source asset (e.g. BTC.BTC)"
},
"target_asset": {
"type": "string",
"description": "Filter by target asset (e.g. ETH.ETH)"
}
},
"additionalProperties": false
}Returns a summary of the limit swaps queue including total count, total USD value, breakdown by asset pair, oldest swap age, and average age. Useful for getting an overview of pending limit orders without retrieving all individual swaps.
| Argument | Type | Description |
|---|---|---|
| source_asset | string | Filter by source asset (e.g. BTC.BTC) |
| target_asset | string | Filter by target asset (e.g. ETH.ETH) |
{
"type": "object",
"properties": {
"source_asset": {
"type": "string",
"description": "Filter by source asset (e.g. BTC.BTC)"
},
"target_asset": {
"type": "string",
"description": "Filter by target asset (e.g. ETH.ETH)"
}
},
"additionalProperties": false
}Returns historical liquidity change data including add/withdraw counts, volumes, and net liquidity over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns liquidity provider position information for a specific address in a pool. Includes units, pending asset/rune, and last add/withdraw heights.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The pool asset (e.g. 'BTC.BTC' or 'ETH.ETH') |
| address* | string | The LP address to lookup |
{
"type": "object",
"required": [
"asset",
"address"
],
"properties": {
"asset": {
"type": "string",
"description": "The pool asset (e.g. 'BTC.BTC' or 'ETH.ETH')"
},
"address": {
"type": "string",
"description": "The LP address to lookup"
}
},
"additionalProperties": false
}Returns list of all liquidity provider addresses.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns balance for an address from Midgard analytics.
| Argument | Type | Description |
|---|---|---|
| address* | string | Address to get balance for |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Address to get balance for"
}
},
"additionalProperties": false
}Returns liquidity provider positions for an address including pool participation, units, and deposit/withdraw history.
| Argument | Type | Description |
|---|---|---|
| address* | string | THORChain address (thor1...) or external chain address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "THORChain address (thor1...) or external chain address"
}
},
"additionalProperties": false
}Returns node information including addresses and public keys from Midgard analytics.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns global network statistics including swap counts, volumes, liquidity metrics, and RUNE price.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns THORChain protocol configuration parameters (Mimir values). These are key-value pairs that control protocol behavior like fees, limits, and feature flags.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the admin mimir configuration. These are protocol parameters set directly by THORChain admins (the dev team) rather than through node voting. Admin overrides take precedence over node votes.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the effective value for a specific mimir key. This shows the final resolved value after considering admin overrides and node voting consensus. Use this to check the current value of any individual protocol parameter.
| Argument | Type | Description |
|---|---|---|
| key* | string | The mimir key to look up (e.g. CHURNINTERVAL, HALTTRADING, etc.) |
{
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "The mimir key to look up (e.g. CHURNINTERVAL, HALTTRADING, etc.)"
}
},
"additionalProperties": false
}Returns the mimir settings voted by a specific node. Shows a map of mimir keys to their voted values for the given node address. Use this to see what protocol parameters a specific node operator is voting for.
| Argument | Type | Description |
|---|---|---|
| address* | string | The node address to get mimir votes for (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The node address to get mimir votes for (thor1...)"
}
},
"additionalProperties": false
}Returns THORChain network statistics and health information including bond metrics, pool data, and node counts.
No arguments.
{
"type": "object",
"additionalProperties": false
}Compact THORChain network status for agents: node counts, bonding/liquidity APY, reserve, pooled RUNE, next churn height, vault migration flag. Prefer this over get_network_info, which returns large per-node bond arrays.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns detailed information for a specific validator node including bond, status, version, and performance metrics. Bond providers include their Bond Yield configuration (bps share of rewards paid out automatically and its payout_target) when one is set.
| Argument | Type | Description |
|---|---|---|
| address* | string | The node address (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The node address (thor1...)"
}
},
"additionalProperties": false
}Returns the oracle price for a specific asset symbol. The price is returned in USD and is used for protocol calculations and limit order pricing.
| Argument | Type | Description |
|---|---|---|
| symbol* | string | The asset symbol to get the price for (e.g. BTC, ETH, RUNE) |
{
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "The asset symbol to get the price for (e.g. BTC, ETH, RUNE)"
}
},
"additionalProperties": false
}Returns all oracle prices for supported assets. Oracle prices are used for determining asset values in the protocol and for pricing limit orders. Returns an array of price objects containing symbol (e.g., BTC, ETH) and price in USD.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns outbound fee information for a specific asset including the fee amount, surplus/deficit tracking, and dynamic multiplier.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The asset to get outbound fee for (e.g. BTC.BTC) |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The asset to get outbound fee for (e.g. BTC.BTC)"
}
},
"additionalProperties": false
}Returns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier. Use this to estimate transaction costs.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the outbound queue containing signed transactions waiting to be broadcast to external chains. Each entry includes the destination chain, address, coin amount, and gas information. These transactions have been signed and are awaiting confirmation.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns detailed information for a specific liquidity pool by asset identifier.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The asset identifier (e.g. BTC.BTC or ETH.ETH) |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The asset identifier (e.g. BTC.BTC or ETH.ETH)"
}
},
"additionalProperties": false
}Returns slip data for one pool, including current slip and rollup statistics.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The pool asset (e.g. BTC.BTC) |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The pool asset (e.g. BTC.BTC)"
}
},
"additionalProperties": false
}Returns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The asset identifier (e.g. BTC.BTC or ETH.ETH) |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The asset identifier (e.g. BTC.BTC or ETH.ETH)"
}
},
"additionalProperties": false
}Returns queue statistics including pending swap count, outbound transaction count, internal queue size, and scheduled outbound value. Use this to understand network congestion.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns whether the chain is in Ragnarok (emergency shutdown mode). Ragnarok is triggered when the network needs to return all funds to users. A true value indicates the network is shutting down.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the memoless transaction memo for a given asset and reference number. Memoless transactions use the amount to encode the reference which maps to a pre-registered memo.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The asset (e.g. BTC.BTC) |
| reference* | string | The reference number |
{
"type": "object",
"required": [
"asset",
"reference"
],
"properties": {
"asset": {
"type": "string",
"description": "The asset (e.g. BTC.BTC)"
},
"reference": {
"type": "string",
"description": "The reference number"
}
},
"additionalProperties": false
}Returns the memoless transaction memo for a given reference hash. Use this to look up the registered memo for a memoless transaction.
| Argument | Type | Description |
|---|---|---|
| hash* | string | The transaction hash |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "The transaction hash"
}
},
"additionalProperties": false
}Returns historical RUNE data including price over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns the RUNEPool state: protocol-owned liquidity, provider shares, reserve position, deposit limits, and pending deposits/withdrawals.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns historical RUNE price data in USD over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns one RUNEPool provider's position: deposited RUNE, units, and PnL.
| Argument | Type | Description |
|---|---|---|
| address* | string | The provider's THORChain address (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The provider's THORChain address (thor1...)"
}
},
"additionalProperties": false
}Returns Midgard's analytics view of a RUNEPool member: deposit/withdraw history and current units.
| Argument | Type | Description |
|---|---|---|
| address* | string | The member's THORChain address (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The member's THORChain address (thor1...)"
}
},
"additionalProperties": false
}Returns the scheduled outbound queue containing transactions waiting to be signed and broadcast. Each entry includes the destination chain, address, coin amount, gas rate, and associated memo. Transactions are scheduled based on outbound delay.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the Stable Reserve module status: RUNE balance, depeg tolerance, POL share, per-asset inventory with health flags and oracle prices, and active deployment swaps. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns a contributor's Stable Reserve credit for a given stable asset and address. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The stable asset (e.g. ETH.USDC-0XA0B8...) |
| address* | string | The contributor's L1 address |
{
"type": "object",
"required": [
"asset",
"address"
],
"properties": {
"asset": {
"type": "string",
"description": "The stable asset (e.g. ETH.USDC-0XA0B8...)"
},
"address": {
"type": "string",
"description": "The contributor's L1 address"
}
},
"additionalProperties": false
}Returns details of a specific streaming swap by transaction hash, including progress (count/quantity), amounts swapped (in/out), and any failed sub-swaps.
| Argument | Type | Description |
|---|---|---|
| hash* | string | The inbound transaction hash of the streaming swap |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "The inbound transaction hash of the streaming swap"
}
},
"additionalProperties": false
}Returns detailed information about a specific swap including its current state. Shows the full swap message with source/target assets, amounts, destination, affiliate info, and the swap's status and queue type. Use this to track the progress of a specific swap transaction.
| Argument | Type | Description |
|---|---|---|
| tx_id* | string | The transaction ID of the swap to look up |
{
"type": "object",
"required": [
"tx_id"
],
"properties": {
"tx_id": {
"type": "string",
"description": "The transaction ID of the swap to look up"
}
},
"additionalProperties": false
}Returns historical swap data including swap counts, volumes, fees, and average slip over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns the current swap queue containing pending swaps waiting to be executed. Each entry includes source/target assets, amounts, destination addresses, and swap state. Use this to monitor swap processing and identify stuck transactions.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns an address's swapper clout: accumulated fee-based score that reduces outbound delays for trusted swappers.
| Argument | Type | Description |
|---|---|---|
| address* | string | The swapper's address (any chain) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The swapper's address (any chain)"
}
},
"additionalProperties": false
}Returns TCY (ThorCoin Yeet) claimer information for a specific address. Takes the claimer's L1 address (e.g. 0x..., bc1..., ltc1...) as listed by list_tcy_claimers and returns the claims (one per asset). Use this to check an individual's TCY claims.
| Argument | Type | Description |
|---|---|---|
| address* | string | The THORChain address to get TCY claimer info for (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The THORChain address to get TCY claimer info for (thor1...)"
}
},
"additionalProperties": false
}Returns TCY distribution for an address.
| Argument | Type | Description |
|---|---|---|
| address* | string | Address to get TCY distribution for |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Address to get TCY distribution for"
}
},
"additionalProperties": false
}Returns TCY (ThorCoin Yeet) staker information for a specific address. Shows the staked amount for the given THORChain address. Use this to check an individual's TCY staking position.
| Argument | Type | Description |
|---|---|---|
| address* | string | The THORChain address to get TCY staker info for (thor1...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The THORChain address to get TCY staker info for (thor1...)"
}
},
"additionalProperties": false
}Returns THORName registration information including owner, expiry, and registered chain addresses. THORNames are human-readable aliases for blockchain addresses.
| Argument | Type | Description |
|---|---|---|
| name* | string | The THORName to lookup (e.g. 't' or 'thorswap') |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The THORName to lookup (e.g. 't' or 'thorswap')"
}
},
"additionalProperties": false
}Returns THORNames owned by an address.
| Argument | Type | Description |
|---|---|---|
| address* | string | Owner address to get THORNames for |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Owner address to get THORNames for"
}
},
"additionalProperties": false
}Returns all trade account positions for a specific address. Each account includes the asset, units, owner, and last activity heights.
| Argument | Type | Description |
|---|---|---|
| address* | string | The address to lookup trade accounts for |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The address to lookup trade accounts for"
}
},
"additionalProperties": false
}Returns trade unit information for a specific asset. Trade units represent the total units and depth of a trade asset pool.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The trade asset to lookup (e.g. 'BTC~BTC' or 'ETH~ETH') |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The trade asset to lookup (e.g. 'BTC~BTC' or 'ETH~ETH')"
}
},
"additionalProperties": false
}Returns TSS keygen and keysign timing metrics across the validator set.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns historical Total Value Locked (TVL) data including pooled value, bonded value, and total locked value over time intervals.
| Argument | Type | Description |
|---|---|---|
| to | integer | End timestamp (Unix seconds) |
| from | integer | Start timestamp (Unix seconds) |
| count | integer | Number of intervals to return |
| interval | string | Time interval: 5min hour day week month quarter year |
{
"type": "object",
"properties": {
"to": {
"type": "integer",
"description": "End timestamp (Unix seconds)"
},
"from": {
"type": "integer",
"description": "Start timestamp (Unix seconds)"
},
"count": {
"type": "integer",
"description": "Number of intervals to return"
},
"interval": {
"type": "string",
"description": "Time interval: 5min hour day week month quarter year"
}
},
"additionalProperties": false
}Returns transaction details for a given hash including observed transaction data, status, and processing stages.
| Argument | Type | Description |
|---|---|---|
| hash* | string | The transaction hash (inbound or outbound) |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "The transaction hash (inbound or outbound)"
}
},
"additionalProperties": false
}Returns comprehensive transaction details including observed transactions, actions taken, outbound transactions, consensus and finalized heights, and whether the vault was updated or the transaction reverted. Use this for deep transaction analysis.
| Argument | Type | Description |
|---|---|---|
| hash* | string | The transaction hash (inbound or outbound) to get detailed information for |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "The transaction hash (inbound or outbound) to get detailed information for"
}
},
"additionalProperties": false
}Returns detailed processing stages of an inbound transaction including observation counts, confirmation status, swap status (with streaming progress if applicable), outbound delay, and signing status.
| Argument | Type | Description |
|---|---|---|
| hash* | string | The inbound transaction hash to check processing stages for |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "The inbound transaction hash to check processing stages for"
}
},
"additionalProperties": false
}Returns comprehensive transaction status including processing stages, planned outbound transactions, and completed outbound transactions. Use this to track swap progress.
| Argument | Type | Description |
|---|---|---|
| hash* | string | The inbound transaction hash to check status for |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "The inbound transaction hash to check status for"
}
},
"additionalProperties": false
}Returns a specific upgrade proposal by name including target block height and upgrade information.
| Argument | Type | Description |
|---|---|---|
| name* | string | The upgrade proposal name (e.g. 'v3.137.0') |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The upgrade proposal name (e.g. 'v3.137.0')"
}
},
"additionalProperties": false
}Returns all node votes for a specific upgrade proposal. Each vote shows the node address and whether they approved. Use this to track upgrade consensus.
| Argument | Type | Description |
|---|---|---|
| name* | string | The upgrade proposal name to get votes for (e.g. 'v3.137.0') |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The upgrade proposal name to get votes for (e.g. 'v3.137.0')"
}
},
"additionalProperties": false
}Returns a specific vault by its public key including coin balances, status, membership, routers, and chain addresses.
| Argument | Type | Description |
|---|---|---|
| pubkey* | string | The vault public key (thorpub1...) |
{
"type": "object",
"required": [
"pubkey"
],
"properties": {
"pubkey": {
"type": "string",
"description": "The vault public key (thorpub1...)"
}
},
"additionalProperties": false
}Returns all vault public keys organized by type: Asgard (active network vaults), Yggdrasil (node vaults), and inactive vaults. Includes router addresses and membership information.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns aggregate vault solvency showing over-solvent or under-solvent amounts per asset. Positive amounts indicate over-solvency (more assets than expected), negative amounts indicate under-solvency. Critical for monitoring vault health.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns network version information including current version, next required version for nodes, and the querier version.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns governance votes including parameter proposals and node votes.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns current Asgard vaults with their pubkeys, coin balances, status, membership, and chain addresses. Asgard vaults are the main network vaults that hold user funds. Supports pagination with limit and offset parameters.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (default 100, max 1000) |
| offset | integer | Number of results to skip for pagination |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Maximum number of results to return (default 100, max 1000)"
},
"offset": {
"type": "integer",
"description": "Number of results to skip for pagination"
}
},
"additionalProperties": false
}Lists all derived (virtual) pools with their depths and status.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns the list of available protocol invariants that can be checked. Invariants are consistency checks that verify the protocol's internal state is valid. Common invariants include 'asgard', 'bond', 'pools', 'thorchain', etc.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all liquidity providers for a specific pool. Each entry includes the LP's units, pending amounts, deposit values, and addresses. Use this to analyze pool participation.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The pool asset (e.g. 'BTC.BTC' or 'ETH.ETH') |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The pool asset (e.g. 'BTC.BTC' or 'ETH.ETH')"
}
},
"additionalProperties": false
}Returns all node operator votes on mimir settings. Each vote shows the mimir key, the voted value, and the node address that cast the vote. Use this to track node consensus on protocol parameter changes.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all registered validator nodes with their status, bond amounts, and operational information. Each bond provider may carry a Bond Yield configuration (bps share of rewards paid out automatically and its payout_target); the fields are absent on nodes without one. Supports pagination with limit and offset parameters.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (default 100, max 1000) |
| offset | integer | Number of results to skip for pagination |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Maximum number of results to return (default 100, max 1000)"
},
"offset": {
"type": "integer",
"description": "Number of results to skip for pagination"
}
},
"additionalProperties": false
}Returns pool slip information for all Layer 1 pools. Pool slip measures trading activity and depth pressure. Shows current slip, rollup counts, and long-term rollup medians used for fee calculations and pool health monitoring.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (default 100, max 1000) |
| offset | integer | Number of results to skip for pagination |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Maximum number of results to return (default 100, max 1000)"
},
"offset": {
"type": "integer",
"description": "Number of results to skip for pagination"
}
},
"additionalProperties": false
}Lists all RUNEPool providers with their deposited RUNE and units.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all active streaming swaps. Streaming swaps split large trades into smaller chunks executed over multiple blocks to minimize slippage. Supports pagination with limit and offset parameters.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (default 100, max 1000) |
| offset | integer | Number of results to skip for pagination |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Maximum number of results to return (default 100, max 1000)"
},
"offset": {
"type": "integer",
"description": "Number of results to skip for pagination"
}
},
"additionalProperties": false
}Returns all TCY (ThorCoin Yeet) claimers. Shows summary information for all addresses that have claimed in the TCY program.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all TCY (ThorCoin Yeet) stakers. Shows summary information for all addresses that have staked in the TCY program.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all trade accounts for a specific trade asset. Each account includes the asset, units, owner address, and activity history.
| Argument | Type | Description |
|---|---|---|
| asset* | string | The trade asset to list accounts for (e.g. 'BTC~BTC' or 'ETH~ETH') |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"description": "The trade asset to list accounts for (e.g. 'BTC~BTC' or 'ETH~ETH')"
}
},
"additionalProperties": false
}Returns all trade units across all trade assets. Each unit includes the asset, total units, and depth.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns all pending network upgrade proposals. Each proposal includes the upgrade name, target block height, and upgrade info. Use this to monitor upcoming network changes.
No arguments.
{
"type": "object",
"additionalProperties": false
}Returns THORName details including chain addresses, expiry, and owner.
| Argument | Type | Description |
|---|---|---|
| name* | string | THORName to look up |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "THORName to look up"
}
},
"additionalProperties": false
}Health check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.
No arguments.
{
"type": "object",
"additionalProperties": false
}Build a ready-to-execute THORChain swap. Returns the exact vault address to send to, the memo, the source chain, the expected output and guaranteed minimum, the estimated time, and an expiry. Use this when the user wants to actually perform a swap, not just price it (for pricing only, use quote_swap). The returned instruction is what a wallet signs and broadcasts; this tool itself never moves funds.
| Argument | Type | Description |
|---|---|---|
| amount* | integer | Amount to swap in THORChain base units (1e8; e.g. 50000000 = 0.5 BTC) |
| to_asset* | string | The target asset to swap to (e.g. ETH.ETH) |
| affiliate | string | Optional affiliate address or THORName that collects a fee |
| from_asset* | string | The source asset to swap from (e.g. BTC.BTC) |
| destination* | string | The address on the destination chain that will receive the swap output. Required to execute a swap. |
| affiliate_bps | integer | Optional affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps) |
| max_slippage_bps |
Get a limit order quote with expected output, expiry time, and a generated memo for executing the limit order. Limit orders execute when the target price is reached.
| Argument | Type | Description |
|---|---|---|
| amount* | integer | The amount in base units (1e8 for most assets) |
| to_asset* | string | The target asset (e.g. ETH.ETH) |
| affiliate | string | The affiliate address or THORName |
| custom_ttl | integer | Custom TTL in blocks for the limit order |
| from_asset* | string | The source asset (e.g. BTC.BTC) |
| target_out* | integer | The limit price: minimum acceptable output amount in base units (1e8). The order executes only at this price or better |
| destination | string | The destination address for the swap output |
| affiliate_bps | integer | The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps) |
Calculate how much output you would receive when swapping one asset for another. Use this tool to answer questions like 'how much ETH would I get for 100 RUNE?' Returns expected output amount, fees, slippage, estimated time, and a memo for executing the swap.
| Argument | Type | Description |
|---|---|---|
| amount* | integer | The amount in base units (1e8 for most assets) |
| to_asset* | string | The target asset (e.g. ETH.ETH) |
| affiliate | string | The affiliate address or THORName |
| from_asset* | string | The source asset (e.g. BTC.BTC) |
| destination | string | The destination address for the swap output |
| affiliate_bps | integer | The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps) |
{
"type": "object",
"required": [
"from_asset",
"to_asset",
"amount"
],
"properties": {
"amount": {
"type": "integer",
"description": "The amount in base units (1e8 for most assets)"
},
"to_asset": {
"type": "string",
"description": "The target asset (e.g. ETH.ETH)"
},
"affiliate": {
"type": "string",
"description": "The affiliate address or THORName"
},
"from_asset": {
"type": "string",
"description": "The source asset (e.g. BTC.BTC)"
},
"destination": {
"type": "string",
"description": "The destination address for the swap output"
},
"affiliate_bps": {
"type": "integer",
"description": "The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)"
}
},
"additionalProperties": false
}Returns THORNames associated with an address.
| Argument | Type | Description |
|---|---|---|
| address* | string | Address to look up THORNames for |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Address to look up THORNames for"
}
},
"additionalProperties": false
}Searches for transactions matching the query. Supports queries like 'tx.height=1000', 'message.action="send"', or composite queries. Returns matching transactions with optional proofs.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). Default is 1. |
| prove | boolean | Include proof for each transaction. |
| query* | string | Search query (e.g. tx.height=1000 or message.action='send'). |
| order_by | string | Result ordering: 'asc' or 'desc'. Default is 'asc'. |
| per_page | integer | Results per page. Default is 30, max is 100. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"description": "Page number (1-indexed). Default is 1."
},
"prove": {
"type": "boolean",
"description": "Include proof for each transaction."
},
"query": {
"type": "string",
"description": "Search query (e.g. tx.height=1000 or message.action='send')."
},
"order_by": {
"type": "string",
"description": "Result ordering: 'asc' or 'desc'. Default is 'asc'."
},
"per_page": {
"type": "integer",
"description": "Results per page. Default is 30, max is 100."
}
},
"additionalProperties": false
}Searches for transactions matching the query events. Supports filtering by message type, sender, recipient, and other event attributes.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). Default is 1. |
| limit | integer | Results per page. Default is 100. |
| events | null | array | Query events to filter transactions (e.g. message.action='send'). Multiple events are ANDed. |
| order_by | string | Result ordering: ORDER_BY_ASC or ORDER_BY_DESC. Default is ORDER_BY_ASC. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Page number (1-indexed). Default is 1."
},
"limit": {
"type": "integer",
"description": "Results per page. Default is 100."
},
"events": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Query events to filter transactions (e.g. message.action='send'). Multiple events are ANDed."
},
"order_by": {
"type": "string",
"description": "Result ordering: ORDER_BY_ASC or ORDER_BY_DESC. Default is ORDER_BY_ASC."
}
},
"additionalProperties": false
}| integer |
| Maximum acceptable slippage in basis points; sets the min-received limit baked into the memo (default 300 = 3%). Range 1-10000. |
{
"type": "object",
"required": [
"from_asset",
"to_asset",
"amount",
"destination"
],
"properties": {
"amount": {
"type": "integer",
"description": "Amount to swap in THORChain base units (1e8; e.g. 50000000 = 0.5 BTC)"
},
"to_asset": {
"type": "string",
"description": "The target asset to swap to (e.g. ETH.ETH)"
},
"affiliate": {
"type": "string",
"description": "Optional affiliate address or THORName that collects a fee"
},
"from_asset": {
"type": "string",
"description": "The source asset to swap from (e.g. BTC.BTC)"
},
"destination": {
"type": "string",
"description": "The address on the destination chain that will receive the swap output. Required to execute a swap."
},
"affiliate_bps": {
"type": "integer",
"description": "Optional affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)"
},
"max_slippage_bps": {
"type": "integer",
"description": "Maximum acceptable slippage in basis points; sets the min-received limit baked into the memo (default 300 = 3%). Range 1-10000."
}
},
"additionalProperties": false
}| refund_address | string | The refund address if the swap fails |
| streaming_quantity | integer | Number of sub-swaps for streaming |
{
"type": "object",
"required": [
"from_asset",
"to_asset",
"amount",
"target_out"
],
"properties": {
"amount": {
"type": "integer",
"description": "The amount in base units (1e8 for most assets)"
},
"to_asset": {
"type": "string",
"description": "The target asset (e.g. ETH.ETH)"
},
"affiliate": {
"type": "string",
"description": "The affiliate address or THORName"
},
"custom_ttl": {
"type": "integer",
"description": "Custom TTL in blocks for the limit order"
},
"from_asset": {
"type": "string",
"description": "The source asset (e.g. BTC.BTC)"
},
"target_out": {
"type": "integer",
"description": "The limit price: minimum acceptable output amount in base units (1e8). The order executes only at this price or better"
},
"destination": {
"type": "string",
"description": "The destination address for the swap output"
},
"affiliate_bps": {
"type": "integer",
"description": "The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)"
},
"refund_address": {
"type": "string",
"description": "The refund address if the swap fails"
},
"streaming_quantity": {
"type": "integer",
"description": "Number of sub-swaps for streaming"
}
},
"additionalProperties": false
}