authorization: Bearer header, except the two sign-in methods.
Sessions
RequestLoginCode
email. Empty response. Repeat requests inside a minute are rejected rather than sending a second email.
VerifyLoginCode
string
required
Address the code was sent to.
string
required
The six-digit code. Valid for minutes and attempts, after which it is discarded.
bool
Extends the session from day to days.
string
Session token. Send as
authorization: Bearer <token>.string
Expiry timestamp.
Logout
API keys
GetPartner
string
Partner email.
PartnerApiKey[]
Existing keys, each with
id, key, name, tier, rate_limit_per_min, disabled, and created_at.int64
Cap on active keys.
CreatePartnerApiKey
name and returns the created key, including its secret value. Name keys after the surface that uses them: the name comes back on attributed orders.
RevokePartnerApiKey
id. Requests using that key then fail with api key disabled, within a few seconds of the change.
Attributed orders
ListPartnerOrders
int64
Page size. Defaults to , clamped to .
string
Cursor from the previous page.
PartnerOrder[]
Each carries
quote_hash, state, src_chain, dst_chain, deposit_token, deposit_amount, deposit_symbol, deposit_decimals, referrer_fee, api_key_name, and created_at.string
Absent on the last page.
Referrals
GetPartnerReferrals
PartnerReferralGroup[]
Each carries
referrer, chain, chain_id, token, token_symbol, decimals, amount, and the count of orders behind it.string
Absent on the last page.
ClaimPartnerReferrer
string
required
Referrer address to claim for.
string
required
Chain the balance accrued on.
string
required
Token the balance is denominated in.
ListPartnerVouchers
VoucherRedeemed events. Takes no arguments.
BuildVoucherRedemption
string
required
Voucher to redeem.
string
required
Address that will pay the transaction fee. It does not have to be the referrer.
string
Prepared transaction, base64 encoded. On Solana it already includes the ed25519 verification instruction the program requires.
redeemVoucher directly with the fields from the voucher; the calldata field on the voucher carries a ready-to-send payload.
Funding
A funding balance pays the relay gas for quotes requested withsponsor_fees, so the cost comes out of the partner’s prepaid balance instead of the user’s output. Deposits are made on one designated chain through the router’s fundPartner entry point; debits happen per sponsored order. See SubmitGaslessOrder.
GetPartnerFunding
string
Total balance across funding tokens, USD micros.
string
The funding chain. Deposits and balances live here.
uint64
Its EVM chain id. Optional.
string
Router contract that
fundPartner is called on.FundingToken[]
Tokens accepted for funding, each with
chain, chain_id, address, symbol, and decimals.PartnerFundingBalance[]
Current balance per token:
token, amount in base units, and usd_micros.BuildPartnerFunding
string
required
One of the accepted funding tokens.
string
required
Amount to deposit, base units.
router_address, ready calldata for fundPartner, and value (non-zero for a native deposit). The deposit is credited once the indexer sees the PartnerFunding event carrying that id.
ListPartnerFundingActivity
limit, defaulting to and clamped to . Returns entries newest first, each with a kind of deposit or debit, the delta, token, created_at, and a status of pending or credited. Deposits carry their funding_id and tx_hash; debits carry the quote_hash of the sponsored order.