Skip to main content
POST
/
intents
/
split
Split Intent by Liquidity
curl --request POST \
  --url https://v1.orchestrator.rhinestone.dev/intents/split \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "chainId": 42161,
  "tokens": {
    "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "5000000000000"
  },
  "settlementLayers": [
    "ACROSS",
    "ECO"
  ]
}
'
{
  "intents": [
    {
      "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "2400000000000"
    },
    {
      "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "1700000000000"
    },
    {
      "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "900000000000"
    }
  ]
}

Headers

​
x-api-key
string
required

Rhinestone API key

​
x-api-version
string

API version (YYYY-MM.name). Will become required in a future release.

Pattern: ^\d{4}-\d{2}\.[a-z0-9]+$
Example:

"2026-01.alps"

Body

application/json

Body

​
chainId
integer
required

The destination chain ID

Required range: x >= 1
Example:

42161

​
tokens
object
required

Map of token addresses to amounts

Example:
{
  "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "5000000000000"
}
​
settlementLayers
enum<string>[]

Optional array of settlement layers to filter by. If not provided, all layers are considered.

Available options:
INTENT_EXECUTOR,
SAME_CHAIN,
ACROSS,
ECO,
RELAY,
OFT,
NEAR
Example:
["ACROSS", "ECO"]

Response

200

Successfully split the intent by available liquidity

​
intents
object[]
required

Array of intents, each mapping token addresses to amounts that can be filled by a single relayer

Example:
[
  {
    "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "2400000000000"
  },
  {
    "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "1700000000000"
  },
  {
    "0xaf88d065e77c8cc2239327c5edb3a432268e5831": "900000000000"
  }
]