Intents

Intent lifecycle

List intents

get

Query parameters

userstringOptional

A valid EVM (0x-prefixed hex) address.

Example: 0x1234567890abcdef1234567890abcdef12345678

deadlineAfterstringOptional

A non-negative integer represented as a decimal string.

Example: 1000000000000000000

deadlineBeforestringOptional

A non-negative integer represented as a decimal string.

Example: 1000000000000000000

settlerstringOptional

A valid EVM (0x-prefixed hex) address.

Example: 0x1234567890abcdef1234567890abcdef12345678

offsetintegerOptionalDefault: 0

limitinteger · min: 1 · max: 100OptionalDefault: 10

Responses

200

List of intents

application/json

opinteger · enumRequired

Intent operation type:

• 0 — Swap
• 1 — Transfer
• 2 — EvmCall
• 3 — SvmCall

Possible values:

userstringRequired

A valid EVM (0x-prefixed hex) address.

Example: 0x1234567890abcdef1234567890abcdef12345678

settlerstringRequired

A valid EVM (0x-prefixed hex) address.

Example: 0x1234567890abcdef1234567890abcdef12345678

noncestringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

deadlinestringRequired

A non-negative integer represented as a decimal string.

Example: 1000000000000000000

datastringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

configSigstringRequired

A 65-byte hex-encoded ECDSA signature (130 hex chars + 0x prefix).

Example: 0xabc...def

minValidationsnumberRequired

hashstringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

executionHashstringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

statusstring · enumRequiredPossible values:

get

/intents

HTTPcURLJavaScriptPython

GET /intents HTTP/1.1
Host: api-protocol.mimic.fi
Accept: */*

200

List of intents

[
  {
    "op": 0,
    "user": "0x1234567890abcdef1234567890abcdef12345678",
    "settler": "0x1234567890abcdef1234567890abcdef12345678",
    "nonce": "0xdeadbeef",
    "deadline": "1000000000000000000",
    "data": "0xdeadbeef",
    "maxFees": [
      {
        "token": "0x1234567890abcdef1234567890abcdef12345678",
        "amount": "1000000000000000000"
      }
    ],
    "events": [
      {
        "topic": "0xdeadbeef",
        "data": "0xdeadbeef"
      }
    ],
    "configSig": "0xabc...def",
    "minValidations": 1,
    "hash": "0xdeadbeef",
    "executionHash": "0xdeadbeef",
    "status": "created",
    "proposals": [
      {
        "solver": "0x1234567890abcdef1234567890abcdef12345678",
        "data": "0xdeadbeef",
        "deadline": "1000000000000000000",
        "fees": [
          "1000000000000000000"
        ],
        "feeUsd": "1000000000000000000",
        "status": "received",
        "description": "text",
        "signatures": [
          "0xabc...def"
        ],
        "transactionHash": "0xdeadbeef",
        "destTransactionHash": "0xdeadbeef"
      }
    ],
    "logs": [
      {
        "level": "info",
        "data": "text",
        "createdAt": "2026-05-08T14:26:24.229Z"
      }
    ]
  }
]

Get an intent by hash

get

Path parameters

hashstringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

Responses

200

Intent details

application/json

opinteger · enumRequired

Intent operation type:

• 0 — Swap
• 1 — Transfer
• 2 — EvmCall
• 3 — SvmCall

Possible values:

userstringRequired

A valid EVM (0x-prefixed hex) address.

Example: 0x1234567890abcdef1234567890abcdef12345678

settlerstringRequired

A valid EVM (0x-prefixed hex) address.

Example: 0x1234567890abcdef1234567890abcdef12345678

noncestringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

deadlinestringRequired

A non-negative integer represented as a decimal string.

Example: 1000000000000000000

datastringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

configSigstringRequired

A 65-byte hex-encoded ECDSA signature (130 hex chars + 0x prefix).

Example: 0xabc...def

minValidationsnumberRequired

hashstringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

executionHashstringRequired

An arbitrary 0x-prefixed hex string.

Example: 0xdeadbeef

statusstring · enumRequiredPossible values:

404

Resource not found

application/json

get

/intents/{hash}

HTTPcURLJavaScriptPython

GET /intents/{hash} HTTP/1.1
Host: api-protocol.mimic.fi
Accept: */*

{
  "op": 0,
  "user": "0x1234567890abcdef1234567890abcdef12345678",
  "settler": "0x1234567890abcdef1234567890abcdef12345678",
  "nonce": "0xdeadbeef",
  "deadline": "1000000000000000000",
  "data": "0xdeadbeef",
  "maxFees": [
    {
      "token": "0x1234567890abcdef1234567890abcdef12345678",
      "amount": "1000000000000000000"
    }
  ],
  "events": [
    {
      "topic": "0xdeadbeef",
      "data": "0xdeadbeef"
    }
  ],
  "configSig": "0xabc...def",
  "minValidations": 1,
  "hash": "0xdeadbeef",
  "executionHash": "0xdeadbeef",
  "status": "created",
  "proposals": [
    {
      "solver": "0x1234567890abcdef1234567890abcdef12345678",
      "data": "0xdeadbeef",
      "deadline": "1000000000000000000",
      "fees": [
        "1000000000000000000"
      ],
      "feeUsd": "1000000000000000000",
      "status": "received",
      "description": "text",
      "signatures": [
        "0xabc...def"
      ],
      "transactionHash": "0xdeadbeef",
      "destTransactionHash": "0xdeadbeef"
    }
  ],
  "logs": [
    {
      "level": "info",
      "data": "text",
      "createdAt": "2026-05-08T14:26:24.229Z"
    }
  ]
}