describeProgram

The most common failure with a filter-based API is a filter that is valid but matches nothing, usually a guessed instruction or role name. describeProgram prevents that by returning the exact names the matcher compares against. Recommended flow: describeProgram to get the exact instruction and role names, build the filter with those names, then subscribe. The Track Jupiter Swaps guide walks through this end to end.

Body

array

required

Hide Query

string

required

A program address (base58) or a catalog name. Prefer the address: names can be ambiguous across program versions (more than one catalog entry is named jupiter, and a name lookup can resolve to the older one). If you do look up by name, check that result.id is the program you intend to subscribe to.

Response

string

The program’s address (base58).

string

The program’s catalog name.

string[]

Decoded instruction names, exactly as the matcher compares them. Use these in the instructionNames filter field.

string[]

Event names the parser recognizes for this program.

string[]

Decoded account role names. Use these as keys in the accounts.roles filter field — they match exactly, with no case folding.

{ "jsonrpc": "2.0", "id": 1, "method": "describeProgram", "params": [{ "program": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4" }] }

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
    "name": "jupiter",
    "instructions": ["route", "shared_accounts_route", "exact_out_route"],
    "events": ["SwapEvent"],
    "roles": ["user_transfer_authority", "destination_token_account"]
  }
}

ping

Webhooks API

⌘I

{ "jsonrpc": "2.0", "id": 1, "method": "describeProgram", "params": [{ "program": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4" }] }

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
    "name": "jupiter",
    "instructions": ["route", "shared_accounts_route", "exact_out_route"],
    "events": ["SwapEvent"],
    "roles": ["user_transfer_authority", "destination_token_account"]
  }
}

API Reference

Solana RPC APIs

Solana APIs

Data Streaming APIs

Event Listening APIs

Account Management APIs

Body

Response

​Body

​Response

Body

Response