perp

Perp Fund

Fund the perp account from a connected wallet.

post/v1/perp/fund

Request

  • Base URL
    https://api.fereai.xyz
  • URL
    https://api.fereai.xyz/v1/perp/fund
  • Auth
    none declared

Query parameters

waitboolean

Block until task completes

timeoutinteger

Seconds to block when wait=true (max 90; the ~100s edge cuts longer waits — use wait=false + poll for longer).

Request body

amountstring required

Amount of the source token in smallest units.

source_chain_idinteger required

Chain holding the source token (e.g. 8453, 42161).

source_tokenstring nullable

ERC-20 address on the source chain, or null for the native gas token.

display_amount_usdnumber nullable

USD amount the user entered (relaxes the post-bridge minimum for typical fee variance).

Example request

{
  "amount": "50000000",
  "display_amount_usd": 50,
  "source_chain_id": 8453
}

Response

Successful Response

task_idstring required

Celery task ID for tracking the async operation.

statusstring

Current task status: queued, pending, started.

poll_urlstring nullable

Relative URL to poll for task status.

notification_streamstring nullable

SSE stream URL for real-time task updates.

Example response

{
  "notification_stream": "/v1/notifications/stream",
  "poll_url": "/v1/tasks/d290f1ee-6c54-4b01-90e6-d701748f0851",
  "status": "queued",
  "task_id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
}

Changes

No recorded changes to this operation across all 1 revision of this API.