bullseye-arrowLimit

Explore authentication, endpoints, and trading operations to start trading efficiently. Whether you're a developer or a trader, this guide has everything you need to get started with Panora's APIs.

1. Create a Limit Order

POST https://api.panora.exchange/limit/v1/createOrder

Headers

  • Public API Key:

    a4^KV_EaTf4MW#ZdvgGKX#HUD^3IFEAOV_kzpIE^3BQGA8pDnrkT7JcIy#HNlLGi

    Note: This API key's limits should be sufficient for most use cases. Protocols within the Aptos ecosystem with specific requirements or customization may submit a ticket on Discord.

Name
Value
Description

x-api-key

Your API Key

Use the public API key or enter the API key provided by Panora

Request Body

Parameter
Required
Type
Descriptio

chainId

no

string

ID for the chain for which the endpoint is being invoked.

toTokenAddress

yes

string

Address of the token you're buying

fromWalletAddress

yes

string

Address of the token you're selling

toWalletAddress

yes

string

Address of the wallet to which the received

tokens will be sent

fromTokenAmount

yes

string

Amount of the token you want to sell

rateToTokenPerFromToken

yes

string

Conversion rate from the token you're selling to the token you're buying

slippagePercentage

no

string

Slippage tolerance as 'auto' (which lets Panora choose the optimal slippage for the transaction, up to a maximum of 5%) or a percentage value.

expiry.value

no

string

Numerical value representing the time until the order expires.

expiry.timePeriod

no

string

Unit of time for the expiry (e.g., "minute", "hour", "day", "week", "month").

Request Example

2. Cancel a Limit Order

POST https://api.panora.exchange/limit/v1/cancelOrder

Request Body

Parameter
Required
Type
Description

chainId

no

string

ID for the chain for which the endpoint is being invoked.

toWalletAddress

no

string

Address of the wallet associated with the transaction to be cancelled.

panoraTxId

yes

string

The Panora transaction ID of the order that needs to be cancelled.

Request Example

3. Get Limit Orders

POST https://api.panora.exchange/limit/v1/getOrders

Parameter
Type
Required
Description

chainId

no

number

ID for the chain for which the endpoint is being invoked.

toWalletAddress

no

string

Address of the wallet associated with the transaction(s).

panoraTxId

no

string

The Panora transaction ID of the order to retrieve.

status

no

"active" | "completed"

Filter orders by status ("active" or "completed").

txDetails

no

boolean

Whether to include detailed transaction data (true or false).

limit

no

number

Maximum number of results to return in a single page.

pageNumber

no

number

Current page number

Request Example

πŸ“¦ LimitOrdersResponse (Object)

Field
Type
Description

chainId

number

ID for the chain for which the endpoint is being invoked.

toWalletAddress

string

Wallet address for which the limit orders were queried

pageNumber

number

Current page number

totalPages

number

Total number of pages available

orders

array

List of limit order objects (see below for structure)

orders[] (Order Object)

Field
Type
Description

panoraTxId

string

Unique Panora transaction ID of the limit order

fromToken

Token

Token being sold

toToken

Token

Token being bought

feeToken

Token

Token used for fees

createdAtTime

string

ISO timestamp when the order was created

status

string

Status of the order: "active", "partially_filled", "filled", "cancelled", "refunded", "expired"

expireAtTime

string

ISO timestamp for when the order expires

fromTokenAmount

string

Total amount of fromToken specified for the order

rateToTokenPerFromToken

string

Exchange rate (toToken per fromToken)

fromTokenAmountSpent

string

Amount of fromToken already spent

fromTokenAmountBalance

string

Remaining fromToken amount left in the order

fromTokenAmountWithdrawn

string

Amount withdrawn from the order manually

toTokenAmountWithdrawn

string

Amount of toToken received from completed portions

numberOfOrdersCompleted

number

Total number of fills completed on this order

avgPriceFromTokenPerToToken

string

Average fill price (fromToken per toToken)

avgPriceToTokenPerFromToken

string

Average fill price (toToken per fromToken)

slippagePercentage

string

Slippage tolerance percentage applied to the order

txDetails (optional)

array

List of transaction events (see below)

txDetails[] (Optional Transaction Data)

Field
Type
Description

txId

string

Transaction ID

txNumber

number

Order event sequence number

type

string

One of: "created", "filled", "attempted", "failed", "cancelled"

attemptNumber

number

Attempt number for execution

fromTokenAmount

string

Amount attempted in this transaction

fromTokenAmountUSD

string

USD equivalent of fromTokenAmount

toTokenAmount

string

Amount of token received in this attempt

toTokenAmountUSD

string

USD equivalent of toTokenAmount

feeTokenAmount

string

Fee charged in this attempt

feeTokenAmountUSD

string

USD equivalent of the fee

time

string

ISO timestamp of this event

priceFromTokenPerToToken (optional)

string

Actual rate in this tx

priceToTokenPerFromToken (optional)

string

Actual reverse rate

keeperWalletAddress (optional)

string

Executor wallet that processed the tx

Token Object

The Token object is a standard representation of a token:

Field
Type
Description

address

string

Token contract address

symbol

string

Symbol of the token (e.g. ETH, USDC)

decimals

number

Number of decimals used by the token

name

string

Human-readable name of the token

Last updated