Skip to main content
GET
/
intents
/
user
/
{sender}
Get user intents
curl --request GET \
  --url https://api.chainrails.io/api/v1/intents/user/{sender} \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 1,
    "client_id": "e1ee3675-cb26-4a76-8206-a84f86e85862",
    "sender": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "initialAmount": "1000000",
    "fees": "10500",
    "totalAmount": "1010500",
    "tokenIn": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
    "tokenOut": "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
    "intent_address": "0x4E60e01263E750eD9D087157e19D2480Fd86A900",
    "destination_intent_address": "0x5F70e12374E750fE0E087158f29E3591Ge97B011",
    "source_chain": "BASE_TESTNET",
    "destination_chain": "ARBITRUM_TESTNET",
    "recipient": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
    "refund_address": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
    "relayer": "",
    "coordinator": "0x989f47053F188778575113DcF39dB8960Fc450e2",
    "bridger": "0xa1c943058a631D5506eb7d96036eAbF6968e2338",
    "bridgeExtraData": "0x00000000000000000000000000000000000000000000000000000000000001f4",
    "intent_nonce": 4267684716645197,
    "intent_status": "COMPLETED",
    "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "needs_relay": false,
    "relayer_claimed": true,
    "paymaster_used": false,
    "mode": "test",
    "expires_at": "2025-12-13T03:31:23.000Z",
    "metadata": {
      "orderId": "12345"
    },
    "created_at": "2025-12-13T02:31:23.390Z",
    "updated_at": "2025-12-13T02:35:10.220Z"
  }
]

Authorizations

​
Authorization
string
header
required

Enter your Chainrails API key as a Bearer token

Path Parameters

​
sender
string
required

User wallet address

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

Response

List of intents for the specified sender

​
id
number
Example:

1

​
client_id
string
Example:

"e1ee3675-cb26-4a76-8206-a84f86e85862"

​
sender
string
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

​
initialAmount
string
Example:

"1000000"

​
fees
string
Example:

"10500"

​
totalAmount
string
Example:

"1010500"

​
tokenIn
string
Example:

"0x036CbD53842c5426634e7929541eC2318f3dCF7e"

​
tokenOut
string
Example:

"0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d"

​
intent_address
string
Example:

"0x4E60e01263E750eD9D087157e19D2480Fd86A900"

​
destination_intent_address
string
Example:

"0x5F70e12374E750fE0E087158f29E3591Ge97B011"

​
source_chain
string
Example:

"BASE_TESTNET"

​
destination_chain
string
Example:

"ARBITRUM_TESTNET"

​
recipient
string
Example:

"0xb79541Be080a59fdcE6C0b43219ba56c725eC65e"

​
refund_address
string
Example:

"0xb79541Be080a59fdcE6C0b43219ba56c725eC65e"

​
relayer
string
Example:

""

​
coordinator
string
Example:

"0x989f47053F188778575113DcF39dB8960Fc450e2"

​
bridger
string
Example:

"0xa1c943058a631D5506eb7d96036eAbF6968e2338"

​
bridgeExtraData
string
Example:

"0x00000000000000000000000000000000000000000000000000000000000001f4"

​
intent_nonce
number
Example:

4267684716645197

​
intent_status
enum<string>
Available options:
PENDING,
FUNDED,
INITIATED,
COMPLETED,
EXPIRED
Example:

"COMPLETED"

​
tx_hash
string
Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

​
needs_relay
boolean
Example:

false

​
relayer_claimed
boolean
Example:

true

​
paymaster_used
boolean
Example:

false

​
mode
enum<string>
Available options:
test,
live
Example:

"test"

​
expires_at
string<date-time>
Example:

"2025-12-13T03:31:23.000Z"

​
metadata
object
Example:
{ "orderId": "12345" }
​
created_at
string<date-time>
Example:

"2025-12-13T02:31:23.390Z"

​
updated_at
string<date-time>
Example:

"2025-12-13T02:35:10.220Z"